)]}'
{"/PATCHSET_LEVEL":[{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"3411a948234ceed662041f1f2b263f1d026508e5","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":10,"id":"797f13e8_271c7458","updated":"2025-04-03 14:05:26.000000000","message":"Hey gleb,\n\nCan you put this under specs/docs/source/specs/stx-11.0/approved/ ?\n... and created the standard subdirectories under ./stx-##.0/ that we usually have.\n\n( I usually do this ... but you beat me to it. )","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"815dc004c48186f064e0fab033032d0dbfcc431e","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":10,"id":"800eee89_d682d58d","in_reply_to":"797f13e8_271c7458","updated":"2025-04-03 14:11:37.000000000","message":"Done","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":35757,"name":"Bruce Jones","email":"bruce.jones@windriver.com","username":"bejones"},"change_message_id":"f5ea5d2ec6d5ba637edbdd4deb9d72795877d689","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":13,"id":"e3c5abf4_af49d808","updated":"2025-04-04 16:06:36.000000000","message":"Very well done indeed.  I think from a content point of view that this is ready to merge.  But please move the spec to the approved directory as Greg suggested first.","commit_id":"6bb3beb6a1cbb4c46e47a93fa49fff1e7ce3cd8f"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"5c311bc02106bfc974f590f7b98bbb35af4f82f7","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":13,"id":"e2ad5083_158545de","in_reply_to":"e3c5abf4_af49d808","updated":"2025-04-04 17:20:08.000000000","message":"Moved.","commit_id":"6bb3beb6a1cbb4c46e47a93fa49fff1e7ce3cd8f"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"e4ba62ce178b868c16a17f95f96d8e3a84398d5b","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":15,"id":"bfe8854d_49c2b4d8","updated":"2025-04-08 16:27:41.000000000","message":"Adding other TSC member","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"c2a69cffb210da10204ab43bced6efc35db86094","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":16,"id":"4f878c54_fc274005","updated":"2025-04-17 13:58:31.000000000","message":"looks good ... just one minor question about duplicated DOCUMENTATION IMPACT section","commit_id":"b03625006beb532ad34f1c1d869d16056f273986"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"d45f22250baf531f610ab434eb3898173a40811d","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":16,"id":"59209959_7476b1b1","in_reply_to":"4f878c54_fc274005","updated":"2025-04-17 15:21:44.000000000","message":"I see what you mean. I removed the first instance.","commit_id":"b03625006beb532ad34f1c1d869d16056f273986"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"84ae9039390e207ad43220a3693cd17bd0dcfd55","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":17,"id":"df9fa3d9_16b19ce0","updated":"2025-04-21 11:37:40.000000000","message":"Thales is on holidays ... I am going to workflow this as it has had decent review.","commit_id":"30a2956217a87932ab534f1a608a3497d36581dd"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"240ce9e791b51e1350c9db89195f95afd7be5344","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":17,"id":"18a5b1a1_59444641","updated":"2025-05-08 01:39:57.000000000","message":"Thales, can you take a look at this ?","commit_id":"30a2956217a87932ab534f1a608a3497d36581dd"}],"doc/source/specs/stx-11.0/approved/app_auto_updating.rst":[{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"0bfb8caa60217915a0934ce4a833504587cc3d56","unresolved":true,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Introduction"},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":15,"context_line":"This toolset automates the upgrade of StarlingX applications as upstream packages are revised. It streamlines the most challenging parts of the update process by employing two key functionalities:"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"- **YAML Markup:**"},{"line_number":18,"context_line":"   Enables precise modification of YAML files and YAML-encoded Helm templates using a dedicated markup configuration."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"- **Helm Template Encoding/Decoding:**"},{"line_number":21,"context_line":"   Converts Helm templates into valid YAML syntax and vice versa, allowing semantic modifications to be applied directly."},{"line_number":22,"context_line":"   During encoding, multi-line Helm blocks are transformed into Base64 encoded placeholders. When decoding, these placeholders are converted back into the original multi-line Helm blocks."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"In addition, the toolset performs all necessary actions to complete a commit for the upgrade. Supporting modules handle tasks such as synchronizing code with upstream, generating commit messages based on version updates and configuration details, creating patch files via git diff, staging the resulting patches, and integrating with Gerrit for code reviews."},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"Problem Description"},{"line_number":27,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"bb2b5547_5ef7d433","line":24,"range":{"start_line":15,"start_character":95,"end_line":24,"end_character":12},"updated":"2025-04-08 16:51:35.000000000","message":"( feel free to ignore this comment )\n\nBut seems to me like you\u0027re jumping way too fast into the details.\nAt this point, I have no idea why you need to do YAML markup or Helm Template encoding/decoding.\n\nCould you get away with just REMOVING this from the Intro ?","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"119363514e6fac099ea5a88fe8ee5b4b4f61b3fa","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Introduction"},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":15,"context_line":"This toolset automates the upgrade of StarlingX applications as upstream packages are revised. It streamlines the most challenging parts of the update process by employing two key functionalities:"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"- **YAML Markup:**"},{"line_number":18,"context_line":"   Enables precise modification of YAML files and YAML-encoded Helm templates using a dedicated markup configuration."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"- **Helm Template Encoding/Decoding:**"},{"line_number":21,"context_line":"   Converts Helm templates into valid YAML syntax and vice versa, allowing semantic modifications to be applied directly."},{"line_number":22,"context_line":"   During encoding, multi-line Helm blocks are transformed into Base64 encoded placeholders. When decoding, these placeholders are converted back into the original multi-line Helm blocks."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"In addition, the toolset performs all necessary actions to complete a commit for the upgrade. Supporting modules handle tasks such as synchronizing code with upstream, generating commit messages based on version updates and configuration details, creating patch files via git diff, staging the resulting patches, and integrating with Gerrit for code reviews."},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"Problem Description"},{"line_number":27,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"b0e50639_90019694","line":24,"range":{"start_line":15,"start_character":95,"end_line":24,"end_character":12},"in_reply_to":"bb2b5547_5ef7d433","updated":"2025-04-16 18:45:05.000000000","message":"Add more overview to the introduction to provided better context, but decided to retain some of the detail.","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"0bfb8caa60217915a0934ce4a833504587cc3d56","unresolved":true,"context_lines":[{"line_number":27,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":28,"context_line":"The current process for updating upstream packages presents several challenges:"},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"- **Recreation for Each Release:**"},{"line_number":31,"context_line":"   Although many required changes are similar between releases, variations in upstream syntax force the manual recreation of new patch files based on the patches used in the prior release."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"- **Manual and Error-Prone Process:**"}],"source_content_type":"text/x-rst","patch_set":15,"id":"be9564cd_b6f5a74d","line":30,"range":{"start_line":30,"start_character":4,"end_line":30,"end_character":15},"updated":"2025-04-08 16:51:35.000000000","message":"? Re-Creation ?","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"119363514e6fac099ea5a88fe8ee5b4b4f61b3fa","unresolved":false,"context_lines":[{"line_number":27,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":28,"context_line":"The current process for updating upstream packages presents several challenges:"},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"- **Recreation for Each Release:**"},{"line_number":31,"context_line":"   Although many required changes are similar between releases, variations in upstream syntax force the manual recreation of new patch files based on the patches used in the prior release."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"- **Manual and Error-Prone Process:**"}],"source_content_type":"text/x-rst","patch_set":15,"id":"84898cfd_342fc288","line":30,"range":{"start_line":30,"start_character":4,"end_line":30,"end_character":15},"in_reply_to":"be9564cd_b6f5a74d","updated":"2025-04-16 18:45:05.000000000","message":"Done","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"0bfb8caa60217915a0934ce4a833504587cc3d56","unresolved":true,"context_lines":[{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Proposed Change"},{"line_number":74,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":75,"context_line":"The proposed change aims to automate the entire upgrade process for StarlingX applications by generating complete code commits that incorporate all necessary modifications. This is achieved by combining core capabilities and supporting modules to handle every aspect of the upgrade."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"1. **Core Capabilities:**"},{"line_number":78,"context_line":""}],"source_content_type":"text/x-rst","patch_set":15,"id":"995ab69b_39e2e536","line":75,"range":{"start_line":75,"start_character":41,"end_line":75,"end_character":48},"updated":"2025-04-08 16:51:35.000000000","message":"entire ? ... does not include testing ... maybe reword ?","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"119363514e6fac099ea5a88fe8ee5b4b4f61b3fa","unresolved":false,"context_lines":[{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Proposed Change"},{"line_number":74,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":75,"context_line":"The proposed change aims to automate the entire upgrade process for StarlingX applications by generating complete code commits that incorporate all necessary modifications. This is achieved by combining core capabilities and supporting modules to handle every aspect of the upgrade."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"1. **Core Capabilities:**"},{"line_number":78,"context_line":""}],"source_content_type":"text/x-rst","patch_set":15,"id":"777115a4_2c20bc38","line":75,"range":{"start_line":75,"start_character":41,"end_line":75,"end_character":48},"in_reply_to":"995ab69b_39e2e536","updated":"2025-04-16 18:45:05.000000000","message":"fixed.","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"0bfb8caa60217915a0934ce4a833504587cc3d56","unresolved":true,"context_lines":[{"line_number":109,"context_line":"REST API Impact"},{"line_number":110,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":111,"context_line":"- The toolset primarily functions as a set of standalone scripts."},{"line_number":112,"context_line":"- When delivered as a web service, a minimal REST API endpoint will be provided for configuration retrieval, update triggering, and code review output."},{"line_number":113,"context_line":"- The web service is designed to run in a Docker container, facilitating deployment and scalability."},{"line_number":114,"context_line":"- There are no anticipated changes to existing upstream APIs, as this functionality is encapsulated within the toolset."},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Security Impact"},{"line_number":117,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"14a5fbe8_6be6dc0c","line":114,"range":{"start_line":112,"start_character":0,"end_line":114,"end_character":119},"updated":"2025-04-08 16:51:35.000000000","message":"Do we need to do this ? ... versus just deliver scripts ?","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"119363514e6fac099ea5a88fe8ee5b4b4f61b3fa","unresolved":false,"context_lines":[{"line_number":109,"context_line":"REST API Impact"},{"line_number":110,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":111,"context_line":"- The toolset primarily functions as a set of standalone scripts."},{"line_number":112,"context_line":"- When delivered as a web service, a minimal REST API endpoint will be provided for configuration retrieval, update triggering, and code review output."},{"line_number":113,"context_line":"- The web service is designed to run in a Docker container, facilitating deployment and scalability."},{"line_number":114,"context_line":"- There are no anticipated changes to existing upstream APIs, as this functionality is encapsulated within the toolset."},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Security Impact"},{"line_number":117,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"9b2ba808_2e919576","line":114,"range":{"start_line":112,"start_character":0,"end_line":114,"end_character":119},"in_reply_to":"14a5fbe8_6be6dc0c","updated":"2025-04-16 18:45:05.000000000","message":"Removed.","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"0bfb8caa60217915a0934ce4a833504587cc3d56","unresolved":true,"context_lines":[{"line_number":477,"context_line":"   [Create Code Review]"},{"line_number":478,"context_line":""},{"line_number":479,"context_line":""},{"line_number":480,"context_line":"Documentation Impact"},{"line_number":481,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":482,"context_line":"- Developer guides will be updated to include detailed instructions for using the toolset."},{"line_number":483,"context_line":"- End-user documentation will outline configuration and operation procedures for both the command-line and web UI interfaces."},{"line_number":484,"context_line":"- The documentation will define the API for each module, including interfaces for orchestration, Git/Gerrit interactions, YAML markup, and Helm template encoding/decoding."},{"line_number":485,"context_line":"- CI/CD pipeline documentation will be revised to incorporate the automated code review output."},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"Extended Command Line Options"},{"line_number":488,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"30de2550_28dca705","line":485,"range":{"start_line":480,"start_character":0,"end_line":485,"end_character":95},"updated":"2025-04-08 16:51:35.000000000","message":"Duplication of lines 286 - 291 ?","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"119363514e6fac099ea5a88fe8ee5b4b4f61b3fa","unresolved":false,"context_lines":[{"line_number":477,"context_line":"   [Create Code Review]"},{"line_number":478,"context_line":""},{"line_number":479,"context_line":""},{"line_number":480,"context_line":"Documentation Impact"},{"line_number":481,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":482,"context_line":"- Developer guides will be updated to include detailed instructions for using the toolset."},{"line_number":483,"context_line":"- End-user documentation will outline configuration and operation procedures for both the command-line and web UI interfaces."},{"line_number":484,"context_line":"- The documentation will define the API for each module, including interfaces for orchestration, Git/Gerrit interactions, YAML markup, and Helm template encoding/decoding."},{"line_number":485,"context_line":"- CI/CD pipeline documentation will be revised to incorporate the automated code review output."},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"Extended Command Line Options"},{"line_number":488,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"ccb53950_f7a58106","line":485,"range":{"start_line":480,"start_character":0,"end_line":485,"end_character":95},"in_reply_to":"30de2550_28dca705","updated":"2025-04-16 18:45:05.000000000","message":"Done","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"0bfb8caa60217915a0934ce4a833504587cc3d56","unresolved":true,"context_lines":[{"line_number":484,"context_line":"- The documentation will define the API for each module, including interfaces for orchestration, Git/Gerrit interactions, YAML markup, and Helm template encoding/decoding."},{"line_number":485,"context_line":"- CI/CD pipeline documentation will be revised to incorporate the automated code review output."},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"Extended Command Line Options"},{"line_number":488,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":489,"context_line":"In addition to the basic encode/decode operations, the tool supports extended options for updating YAML files:"},{"line_number":490,"context_line":""},{"line_number":491,"context_line":"- **--input-dirs:** Specifies one or more directories containing YAML files to be processed."},{"line_number":492,"context_line":"- **--output-dir:** Designates the directory where updated YAML files will be saved."},{"line_number":493,"context_line":"- **--markup-file:** Specifies the YAML markup file that defines the transformation rules."},{"line_number":494,"context_line":"- **--prefix:** (Optional) A prefix for output file names."},{"line_number":495,"context_line":"- **--exclude-types:** (Optional) A list of resource types to exclude from processing (e.g., \"Namespace\", \"Pod\")."},{"line_number":496,"context_line":"- **--single-output:** (Optional) If provided, all updated YAML documents are output to a single file, separated by document markers."},{"line_number":497,"context_line":""},{"line_number":498,"context_line":"References"},{"line_number":499,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"a10f49a9_39018ccc","line":496,"range":{"start_line":487,"start_character":0,"end_line":496,"end_character":133},"updated":"2025-04-08 16:51:35.000000000","message":"Duplication of lines 235 - 244 ?","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"119363514e6fac099ea5a88fe8ee5b4b4f61b3fa","unresolved":false,"context_lines":[{"line_number":484,"context_line":"- The documentation will define the API for each module, including interfaces for orchestration, Git/Gerrit interactions, YAML markup, and Helm template encoding/decoding."},{"line_number":485,"context_line":"- CI/CD pipeline documentation will be revised to incorporate the automated code review output."},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"Extended Command Line Options"},{"line_number":488,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":489,"context_line":"In addition to the basic encode/decode operations, the tool supports extended options for updating YAML files:"},{"line_number":490,"context_line":""},{"line_number":491,"context_line":"- **--input-dirs:** Specifies one or more directories containing YAML files to be processed."},{"line_number":492,"context_line":"- **--output-dir:** Designates the directory where updated YAML files will be saved."},{"line_number":493,"context_line":"- **--markup-file:** Specifies the YAML markup file that defines the transformation rules."},{"line_number":494,"context_line":"- **--prefix:** (Optional) A prefix for output file names."},{"line_number":495,"context_line":"- **--exclude-types:** (Optional) A list of resource types to exclude from processing (e.g., \"Namespace\", \"Pod\")."},{"line_number":496,"context_line":"- **--single-output:** (Optional) If provided, all updated YAML documents are output to a single file, separated by document markers."},{"line_number":497,"context_line":""},{"line_number":498,"context_line":"References"},{"line_number":499,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":15,"id":"5aca6997_84d76642","line":496,"range":{"start_line":487,"start_character":0,"end_line":496,"end_character":133},"in_reply_to":"a10f49a9_39018ccc","updated":"2025-04-16 18:45:05.000000000","message":"removed","commit_id":"cc50d338062f9b57004682932fe62d622709d754"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"c2a69cffb210da10204ab43bced6efc35db86094","unresolved":true,"context_lines":[{"line_number":476,"context_line":"   [Create Code Review]"},{"line_number":477,"context_line":""},{"line_number":478,"context_line":""},{"line_number":479,"context_line":"Documentation Impact"},{"line_number":480,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":481,"context_line":"- Developer guides will be updated to include detailed instructions for using the toolset."},{"line_number":482,"context_line":"- End-user documentation will outline configuration and operation procedures for both the command-line and web UI interfaces."},{"line_number":483,"context_line":"- The documentation will define the API for each module, including interfaces for orchestration, Git/Gerrit interactions, YAML markup, and Helm template encoding/decoding."},{"line_number":484,"context_line":"- CI/CD pipeline documentation will be revised to incorporate the automated code review output."},{"line_number":485,"context_line":""},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":16,"id":"36d3fbb2_5acdaa6d","line":484,"range":{"start_line":479,"start_character":0,"end_line":484,"end_character":95},"updated":"2025-04-17 13:58:31.000000000","message":"Why do you have these same lines in two places ?\nsee lines 285-290","commit_id":"b03625006beb532ad34f1c1d869d16056f273986"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"d45f22250baf531f610ab434eb3898173a40811d","unresolved":false,"context_lines":[{"line_number":476,"context_line":"   [Create Code Review]"},{"line_number":477,"context_line":""},{"line_number":478,"context_line":""},{"line_number":479,"context_line":"Documentation Impact"},{"line_number":480,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":481,"context_line":"- Developer guides will be updated to include detailed instructions for using the toolset."},{"line_number":482,"context_line":"- End-user documentation will outline configuration and operation procedures for both the command-line and web UI interfaces."},{"line_number":483,"context_line":"- The documentation will define the API for each module, including interfaces for orchestration, Git/Gerrit interactions, YAML markup, and Helm template encoding/decoding."},{"line_number":484,"context_line":"- CI/CD pipeline documentation will be revised to incorporate the automated code review output."},{"line_number":485,"context_line":""},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":16,"id":"54746ac2_0077bf07","line":484,"range":{"start_line":479,"start_character":0,"end_line":484,"end_character":95},"in_reply_to":"36d3fbb2_5acdaa6d","updated":"2025-04-17 15:21:44.000000000","message":"Done","commit_id":"b03625006beb532ad34f1c1d869d16056f273986"}],"specs/2025.09/approved/app_auto_updating.rst":[{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":1,"context_line":".. This work is licensed under a Creative Commons Attribution 3.0 Unported"},{"line_number":2,"context_line":"   License."},{"line_number":3,"context_line":".. http://creativecommons.org/licenses/by/3.0/legalcode"},{"line_number":4,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5e0897b3_0d2c8474","line":1,"updated":"2025-04-03 14:46:17.000000000","message":"should we use version 4.0? 3.0 is older version","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":26026,"name":"Greg Waines","email":"greg.waines@windriver.com","username":"gwaines"},"change_message_id":"502faa46f8c3092dd179f32c220fc9f02ccef4da","unresolved":true,"context_lines":[{"line_number":1,"context_line":".. This work is licensed under a Creative Commons Attribution 3.0 Unported"},{"line_number":2,"context_line":"   License."},{"line_number":3,"context_line":".. http://creativecommons.org/licenses/by/3.0/legalcode"},{"line_number":4,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"d9ff6c4d_569481d2","line":1,"in_reply_to":"1f3fd626_06072418","updated":"2025-04-17 14:00:16.000000000","message":"This simply comes from our SPECS template that could easily be out-of-date.\nI\u0027m fine with changing to 4.0 .","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":true,"context_lines":[{"line_number":1,"context_line":".. This work is licensed under a Creative Commons Attribution 3.0 Unported"},{"line_number":2,"context_line":"   License."},{"line_number":3,"context_line":".. http://creativecommons.org/licenses/by/3.0/legalcode"},{"line_number":4,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"1f3fd626_06072418","line":1,"in_reply_to":"5e0897b3_0d2c8474","updated":"2025-04-04 14:44:21.000000000","message":"I\u0027m not sure.  @greg.waines@windriver.com can you comment on this?  The last commit in this repo used 3.0.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"d45f22250baf531f610ab434eb3898173a40811d","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. This work is licensed under a Creative Commons Attribution 3.0 Unported"},{"line_number":2,"context_line":"   License."},{"line_number":3,"context_line":".. http://creativecommons.org/licenses/by/3.0/legalcode"},{"line_number":4,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"1b7bb851_7161b98e","line":1,"in_reply_to":"d9ff6c4d_569481d2","updated":"2025-04-17 15:21:44.000000000","message":"Done","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":12,"context_line":"Introduction"},{"line_number":13,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":14,"context_line":"This toolset automates StarlingX application updates by streamlining the most"},{"line_number":15,"context_line":"challenging parts of updating upstream packages. The key functionalities include:"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"- **YAML Markup:** Enables modification of YAML files and YAML-encoded Helm templates"},{"line_number":18,"context_line":"  using a dedicated markup configuration."}],"source_content_type":"text/x-rst","patch_set":10,"id":"491553b7_23f4e7d7","line":15,"updated":"2025-04-03 14:46:17.000000000","message":"maybe a good idea to describe the entire flow, then highlight which part of the updating upstream packages will be replaced by this toolset","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":12,"context_line":"Introduction"},{"line_number":13,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":14,"context_line":"This toolset automates StarlingX application updates by streamlining the most"},{"line_number":15,"context_line":"challenging parts of updating upstream packages. The key functionalities include:"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"- **YAML Markup:** Enables modification of YAML files and YAML-encoded Helm templates"},{"line_number":18,"context_line":"  using a dedicated markup configuration."}],"source_content_type":"text/x-rst","patch_set":10,"id":"5d7c6363_3d778d44","line":15,"in_reply_to":"491553b7_23f4e7d7","updated":"2025-04-04 14:44:21.000000000","message":"Add a section to describe flow.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":52,"context_line":""},{"line_number":53,"context_line":"2. **DevOps/Operators:**"},{"line_number":54,"context_line":"   - **Interface Options:** The tool can be executed via the command line or a web-based UI,"},{"line_number":55,"context_line":"     allowing users to easily select target versions and branches."},{"line_number":56,"context_line":"   - **Consistent and Transparent Updates:** The automated process ensures that YAML"},{"line_number":57,"context_line":"     modifications are applied consistently, simplifying code review diffs and reducing"},{"line_number":58,"context_line":"     errors."}],"source_content_type":"text/x-rst","patch_set":10,"id":"71b60256_1ed0fb8a","line":55,"updated":"2025-04-03 14:46:17.000000000","message":"WebUI is stright forward, but what is missing is the description on how to use command line to perform the operation","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":52,"context_line":""},{"line_number":53,"context_line":"2. **DevOps/Operators:**"},{"line_number":54,"context_line":"   - **Interface Options:** The tool can be executed via the command line or a web-based UI,"},{"line_number":55,"context_line":"     allowing users to easily select target versions and branches."},{"line_number":56,"context_line":"   - **Consistent and Transparent Updates:** The automated process ensures that YAML"},{"line_number":57,"context_line":"     modifications are applied consistently, simplifying code review diffs and reducing"},{"line_number":58,"context_line":"     errors."}],"source_content_type":"text/x-rst","patch_set":10,"id":"6fdbd421_72b7f753","line":55,"in_reply_to":"71b60256_1ed0fb8a","updated":"2025-04-04 14:44:21.000000000","message":"Done","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":76,"context_line":"1. **Helm Template Encoding/Decoding:**"},{"line_number":77,"context_line":"   - **Purpose:** Convert Helm templates into valid YAML syntax and vice versa."},{"line_number":78,"context_line":"   - **Functionality:** This capability enables the toolset to interpret and manipulate Helm"},{"line_number":79,"context_line":"     charts as YAML files, which is essential for applying semantic modifications."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"2. **YAML Markup and Transformation:**"},{"line_number":82,"context_line":"   - **Purpose:** Modify YAML files that include encoded Helm templates."}],"source_content_type":"text/x-rst","patch_set":10,"id":"5dbed023_fc1dee18","line":79,"updated":"2025-04-03 14:46:17.000000000","message":"Might need an example on how the codec (encode and decode) works","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":76,"context_line":"1. **Helm Template Encoding/Decoding:**"},{"line_number":77,"context_line":"   - **Purpose:** Convert Helm templates into valid YAML syntax and vice versa."},{"line_number":78,"context_line":"   - **Functionality:** This capability enables the toolset to interpret and manipulate Helm"},{"line_number":79,"context_line":"     charts as YAML files, which is essential for applying semantic modifications."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"2. **YAML Markup and Transformation:**"},{"line_number":82,"context_line":"   - **Purpose:** Modify YAML files that include encoded Helm templates."}],"source_content_type":"text/x-rst","patch_set":10,"id":"21a54914_d99497db","line":79,"in_reply_to":"5dbed023_fc1dee18","updated":"2025-04-04 14:44:21.000000000","message":"Done","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":98,"context_line":""},{"line_number":99,"context_line":"Process Flow Overview"},{"line_number":100,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":101,"context_line":"- **Selection:** Developers select an upstream target version and branch."},{"line_number":102,"context_line":"- **Code Pull:** The tool pulls the corresponding upstream code into the local build"},{"line_number":103,"context_line":"  environment."},{"line_number":104,"context_line":"- **Transformation:** The YAML markup configuration is applied to the encoded Helm"},{"line_number":105,"context_line":"  templates, performing add, delete, or update operations as defined by the schema."},{"line_number":106,"context_line":"- **Supporting Operations:** The workflow orchestration module triggers the code"},{"line_number":107,"context_line":"  synchronization and file operations modules, ensuring that all modifications are"},{"line_number":108,"context_line":"  processed."},{"line_number":109,"context_line":"- **Output:** A code review is generated that details all modifications. This output can be"},{"line_number":110,"context_line":"  optionally integrated into CI/CD pipelines for further automated testing and review."},{"line_number":111,"context_line":""},{"line_number":112,"context_line":"Data Model Impact"},{"line_number":113,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":10,"id":"0f48b5f2_94f41754","line":110,"range":{"start_line":101,"start_character":2,"end_line":110,"end_character":86},"updated":"2025-04-03 14:46:17.000000000","message":"a diagram will be better to describe the flow","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":98,"context_line":""},{"line_number":99,"context_line":"Process Flow Overview"},{"line_number":100,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":101,"context_line":"- **Selection:** Developers select an upstream target version and branch."},{"line_number":102,"context_line":"- **Code Pull:** The tool pulls the corresponding upstream code into the local build"},{"line_number":103,"context_line":"  environment."},{"line_number":104,"context_line":"- **Transformation:** The YAML markup configuration is applied to the encoded Helm"},{"line_number":105,"context_line":"  templates, performing add, delete, or update operations as defined by the schema."},{"line_number":106,"context_line":"- **Supporting Operations:** The workflow orchestration module triggers the code"},{"line_number":107,"context_line":"  synchronization and file operations modules, ensuring that all modifications are"},{"line_number":108,"context_line":"  processed."},{"line_number":109,"context_line":"- **Output:** A code review is generated that details all modifications. This output can be"},{"line_number":110,"context_line":"  optionally integrated into CI/CD pipelines for further automated testing and review."},{"line_number":111,"context_line":""},{"line_number":112,"context_line":"Data Model Impact"},{"line_number":113,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":10,"id":"54c05056_4fdcd858","line":110,"range":{"start_line":101,"start_character":2,"end_line":110,"end_character":86},"in_reply_to":"0f48b5f2_94f41754","updated":"2025-04-04 14:44:21.000000000","message":"Done","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":111,"context_line":""},{"line_number":112,"context_line":"Data Model Impact"},{"line_number":113,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":114,"context_line":"- **Markup Language Grammar:** A new YAML schema file will define the grammar of the markup"},{"line_number":115,"context_line":"  language, specifying the types of changes (e.g., add, update, delete) applicable to Helm"},{"line_number":116,"context_line":"  templates and other YAML files."},{"line_number":117,"context_line":"- **Versioning:** The schema file will be versioned to ensure backward compatibility and to"}],"source_content_type":"text/x-rst","patch_set":10,"id":"abbcd1a6_36c931c6","line":114,"updated":"2025-04-03 14:46:17.000000000","message":"Markup Language Grammar will be in separated design document?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":111,"context_line":""},{"line_number":112,"context_line":"Data Model Impact"},{"line_number":113,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":114,"context_line":"- **Markup Language Grammar:** A new YAML schema file will define the grammar of the markup"},{"line_number":115,"context_line":"  language, specifying the types of changes (e.g., add, update, delete) applicable to Helm"},{"line_number":116,"context_line":"  templates and other YAML files."},{"line_number":117,"context_line":"- **Versioning:** The schema file will be versioned to ensure backward compatibility and to"}],"source_content_type":"text/x-rst","patch_set":10,"id":"d59f4410_77ec9ee8","line":114,"in_reply_to":"abbcd1a6_36c931c6","updated":"2025-04-04 14:44:21.000000000","message":"I think so.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":119,"context_line":"- **Configuration File Updates:** No changes are made to underlying data models; the"},{"line_number":120,"context_line":"  impact is confined to the introduction and modification of configuration files managed by"},{"line_number":121,"context_line":"  the toolset."},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"REST API Impact"},{"line_number":124,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":125,"context_line":"- The toolset primarily functions as a set of standalone scripts."}],"source_content_type":"text/x-rst","patch_set":10,"id":"99fbea53_7c337559","line":122,"updated":"2025-04-03 14:46:17.000000000","message":"just a suggestion, should we include an example of configuration file and markup file","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":119,"context_line":"- **Configuration File Updates:** No changes are made to underlying data models; the"},{"line_number":120,"context_line":"  impact is confined to the introduction and modification of configuration files managed by"},{"line_number":121,"context_line":"  the toolset."},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"REST API Impact"},{"line_number":124,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":125,"context_line":"- The toolset primarily functions as a set of standalone scripts."}],"source_content_type":"text/x-rst","patch_set":10,"id":"4ff6bd78_1bb5f8b0","line":122,"in_reply_to":"99fbea53_7c337559","updated":"2025-04-04 14:44:21.000000000","message":"I added an example for markup.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":120,"context_line":"  impact is confined to the introduction and modification of configuration files managed by"},{"line_number":121,"context_line":"  the toolset."},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"REST API Impact"},{"line_number":124,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":125,"context_line":"- The toolset primarily functions as a set of standalone scripts."},{"line_number":126,"context_line":"- When delivered as a web service, a minimal REST API endpoint will be provided for"}],"source_content_type":"text/x-rst","patch_set":10,"id":"2df01e3e_629bcdee","line":123,"updated":"2025-04-03 14:46:17.000000000","message":"REST API is only for WebUI. I remember you mention between modules interface just direct function call. is there any module APIs should be describe in the document?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":120,"context_line":"  impact is confined to the introduction and modification of configuration files managed by"},{"line_number":121,"context_line":"  the toolset."},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"REST API Impact"},{"line_number":124,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":125,"context_line":"- The toolset primarily functions as a set of standalone scripts."},{"line_number":126,"context_line":"- When delivered as a web service, a minimal REST API endpoint will be provided for"}],"source_content_type":"text/x-rst","patch_set":10,"id":"f0b6abad_3b161337","line":123,"in_reply_to":"2df01e3e_629bcdee","updated":"2025-04-04 14:44:21.000000000","message":"Some API definitions added.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":137,"context_line":"  as part of the development and deployment processes."},{"line_number":138,"context_line":"- Existing security policies and best practices for handling YAML files, Docker containers,"},{"line_number":139,"context_line":"  and web services will continue to be enforced."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Other End User Impact"},{"line_number":142,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":143,"context_line":"- The toolset primarily targets automation of upstream updates and does not directly alter"}],"source_content_type":"text/x-rst","patch_set":10,"id":"de0ffdb7_902c0c97","line":140,"updated":"2025-04-03 14:46:17.000000000","message":"shpuld we mention the possible security impact introduced by AI-generated code","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":137,"context_line":"  as part of the development and deployment processes."},{"line_number":138,"context_line":"- Existing security policies and best practices for handling YAML files, Docker containers,"},{"line_number":139,"context_line":"  and web services will continue to be enforced."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Other End User Impact"},{"line_number":142,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":143,"context_line":"- The toolset primarily targets automation of upstream updates and does not directly alter"}],"source_content_type":"text/x-rst","patch_set":10,"id":"b18b57aa_04905740","line":140,"in_reply_to":"de0ffdb7_902c0c97","updated":"2025-04-04 14:44:21.000000000","message":"I don\u0027t think there is any impact in this use case.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":175,"context_line":""},{"line_number":176,"context_line":"Upgrade Impact"},{"line_number":177,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":178,"context_line":"- The toolset will support backward compatibility by maintaining legacy encoding formats where"},{"line_number":179,"context_line":"  necessary."},{"line_number":180,"context_line":"- Migration guides will be provided to facilitate schema updates or changes in YAML"},{"line_number":181,"context_line":"  transformations."}],"source_content_type":"text/x-rst","patch_set":10,"id":"c1269171_5e1b8387","line":178,"range":{"start_line":178,"start_character":66,"end_line":178,"end_character":89},"updated":"2025-04-03 14:46:17.000000000","message":"not sure what is the legacy encoding formats was referring?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":175,"context_line":""},{"line_number":176,"context_line":"Upgrade Impact"},{"line_number":177,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":178,"context_line":"- The toolset will support backward compatibility by maintaining legacy encoding formats where"},{"line_number":179,"context_line":"  necessary."},{"line_number":180,"context_line":"- Migration guides will be provided to facilitate schema updates or changes in YAML"},{"line_number":181,"context_line":"  transformations."}],"source_content_type":"text/x-rst","patch_set":10,"id":"4f6861bf_c921e5f2","line":178,"range":{"start_line":178,"start_character":66,"end_line":178,"end_character":89},"in_reply_to":"c1269171_5e1b8387","updated":"2025-04-04 14:44:21.000000000","message":"removed.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":177,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":178,"context_line":"- The toolset will support backward compatibility by maintaining legacy encoding formats where"},{"line_number":179,"context_line":"  necessary."},{"line_number":180,"context_line":"- Migration guides will be provided to facilitate schema updates or changes in YAML"},{"line_number":181,"context_line":"  transformations."},{"line_number":182,"context_line":"- Automation reduces manual overhead during upgrades, ensuring modifications are applied"},{"line_number":183,"context_line":"  consistently across upstream releases."}],"source_content_type":"text/x-rst","patch_set":10,"id":"b4d9d1a1_ac25daf7","line":180,"range":{"start_line":180,"start_character":2,"end_line":180,"end_character":18},"updated":"2025-04-03 14:46:17.000000000","message":"Migration guides for each application?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":177,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":178,"context_line":"- The toolset will support backward compatibility by maintaining legacy encoding formats where"},{"line_number":179,"context_line":"  necessary."},{"line_number":180,"context_line":"- Migration guides will be provided to facilitate schema updates or changes in YAML"},{"line_number":181,"context_line":"  transformations."},{"line_number":182,"context_line":"- Automation reduces manual overhead during upgrades, ensuring modifications are applied"},{"line_number":183,"context_line":"  consistently across upstream releases."}],"source_content_type":"text/x-rst","patch_set":10,"id":"1c299f75_f55989cb","line":180,"range":{"start_line":180,"start_character":2,"end_line":180,"end_character":18},"in_reply_to":"b4d9d1a1_ac25daf7","updated":"2025-04-04 14:44:21.000000000","message":"Removed.  We can define what migration (if needed) at later time.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":187,"context_line":"The implementation will proceed in the following phases:"},{"line_number":188,"context_line":""},{"line_number":189,"context_line":"1. **Design \u0026 Prototyping:**"},{"line_number":190,"context_line":"   - Define input/output schemas for YAML and encoded Helm templates."},{"line_number":191,"context_line":"   - Prototype the encoding/decoding and YAML markup functionalities."},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"2. **Development:**"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3aa88965_cf4bd16a","line":190,"range":{"start_line":190,"start_character":5,"end_line":190,"end_character":68},"updated":"2025-04-03 14:46:17.000000000","message":"is this will included in this document, or there will be separated document to describe the detail?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":187,"context_line":"The implementation will proceed in the following phases:"},{"line_number":188,"context_line":""},{"line_number":189,"context_line":"1. **Design \u0026 Prototyping:**"},{"line_number":190,"context_line":"   - Define input/output schemas for YAML and encoded Helm templates."},{"line_number":191,"context_line":"   - Prototype the encoding/decoding and YAML markup functionalities."},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"2. **Development:**"}],"source_content_type":"text/x-rst","patch_set":10,"id":"f403c12c_1d51553c","line":190,"range":{"start_line":190,"start_character":5,"end_line":190,"end_character":68},"in_reply_to":"3aa88965_cf4bd16a","updated":"2025-04-04 14:44:21.000000000","message":"Different document.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":205,"context_line":"   - Create comprehensive user and developer documentation."},{"line_number":206,"context_line":"   - Perform peer reviews and iterate based on feedback."},{"line_number":207,"context_line":"   - Prepare detailed migration and upgrade guides."},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Assignee(s)"},{"line_number":210,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":211,"context_line":"Primary Assignee: gleb.aronsky@windriver.com"}],"source_content_type":"text/x-rst","patch_set":10,"id":"bd00eb90_4d565200","line":208,"updated":"2025-04-03 14:46:17.000000000","message":"should we add another item to describe the limitation of this toolset?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":205,"context_line":"   - Create comprehensive user and developer documentation."},{"line_number":206,"context_line":"   - Perform peer reviews and iterate based on feedback."},{"line_number":207,"context_line":"   - Prepare detailed migration and upgrade guides."},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Assignee(s)"},{"line_number":210,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":211,"context_line":"Primary Assignee: gleb.aronsky@windriver.com"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3b53d4ed_9e339f0b","line":208,"in_reply_to":"bd00eb90_4d565200","updated":"2025-04-04 14:44:21.000000000","message":"That should probably be documented as part of the tool documentation, I don\u0027t think it needs to be part of the spec.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":225,"context_line":"- Develop the web server and UI components."},{"line_number":226,"context_line":"- Build supporting modules for Gerrit and Git interactions."},{"line_number":227,"context_line":"- Prepare integration tests and comprehensive documentation."},{"line_number":228,"context_line":""},{"line_number":229,"context_line":"Dependencies"},{"line_number":230,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":231,"context_line":"- Python 3.9+"}],"source_content_type":"text/x-rst","patch_set":10,"id":"6eef8fa0_1e9e4088","line":228,"updated":"2025-04-03 14:46:17.000000000","message":"Should prepare the package either in docker or other format for delivery as a work item, or it is already done.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":225,"context_line":"- Develop the web server and UI components."},{"line_number":226,"context_line":"- Build supporting modules for Gerrit and Git interactions."},{"line_number":227,"context_line":"- Prepare integration tests and comprehensive documentation."},{"line_number":228,"context_line":""},{"line_number":229,"context_line":"Dependencies"},{"line_number":230,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":231,"context_line":"- Python 3.9+"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a7db7af_87f32ef2","line":228,"in_reply_to":"6eef8fa0_1e9e4088","updated":"2025-04-04 14:44:21.000000000","message":"The packaging would need to be done as part of the implementation of the spec.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":233,"context_line":"- Helm CLI (for compatibility checks and validations)"},{"line_number":234,"context_line":"- Docker (for containerized deployment)"},{"line_number":235,"context_line":"- Standard logging and configuration libraries"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"Testing"},{"line_number":238,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":239,"context_line":"- **Unit Testing:** Ensure all functions in the encoding/decoding and YAML markup modules"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3d1fe95d_7ebadaa1","line":236,"updated":"2025-04-03 14:46:17.000000000","message":"Git is another dependency\nIs there any browser requirement?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":233,"context_line":"- Helm CLI (for compatibility checks and validations)"},{"line_number":234,"context_line":"- Docker (for containerized deployment)"},{"line_number":235,"context_line":"- Standard logging and configuration libraries"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"Testing"},{"line_number":238,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":239,"context_line":"- **Unit Testing:** Ensure all functions in the encoding/decoding and YAML markup modules"}],"source_content_type":"text/x-rst","patch_set":10,"id":"4f55aee5_77004506","line":236,"in_reply_to":"3d1fe95d_7ebadaa1","updated":"2025-04-04 14:44:21.000000000","message":"No other dependency defined in the spec.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":37446,"name":"Wey-Yi W Guy","display_name":"wguy","email":"Wey-Yi.Guy@windriver.com","username":"wguy"},"change_message_id":"70d16552df6503528e0e38f1ca4e0501c8fa648c","unresolved":true,"context_lines":[{"line_number":240,"context_line":"  operate as expected."},{"line_number":241,"context_line":"- **Integration Testing:** Test the complete workflow from upstream code pull to code review"},{"line_number":242,"context_line":"  generation, including CI/CD pipeline integration."},{"line_number":243,"context_line":"- **Edge Case Testing:** Validate the toolset\u0027s behavior with malformed YAML inputs,"},{"line_number":244,"context_line":"  unexpected Helm template structures, and error conditions."},{"line_number":245,"context_line":""},{"line_number":246,"context_line":"Documentation Impact"}],"source_content_type":"text/x-rst","patch_set":10,"id":"6d2d7638_936d275e","line":243,"range":{"start_line":243,"start_character":4,"end_line":243,"end_character":22},"updated":"2025-04-03 14:46:17.000000000","message":"both positive and negative test, correct?","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"},{"author":{"_account_id":34064,"name":"Gleb Aronsky","email":"gleb.aronsky@windriver.com","username":"garonsky"},"change_message_id":"4c0f9bf299dd99e6515c915900bee389351f3ba2","unresolved":false,"context_lines":[{"line_number":240,"context_line":"  operate as expected."},{"line_number":241,"context_line":"- **Integration Testing:** Test the complete workflow from upstream code pull to code review"},{"line_number":242,"context_line":"  generation, including CI/CD pipeline integration."},{"line_number":243,"context_line":"- **Edge Case Testing:** Validate the toolset\u0027s behavior with malformed YAML inputs,"},{"line_number":244,"context_line":"  unexpected Helm template structures, and error conditions."},{"line_number":245,"context_line":""},{"line_number":246,"context_line":"Documentation Impact"}],"source_content_type":"text/x-rst","patch_set":10,"id":"4a480b45_6542638d","line":243,"range":{"start_line":243,"start_character":4,"end_line":243,"end_character":22},"in_reply_to":"6d2d7638_936d275e","updated":"2025-04-04 14:44:21.000000000","message":"Yes.","commit_id":"bd571be4c61d43747b93fa1afb27d3ec39169cd6"}]}