From 9b60a4e12d4b4840b2b02eec3a92ddfa4610ff46 Mon Sep 17 00:00:00 2001 From: Philipp Ahmann Date: Thu, 18 Dec 2025 10:23:07 +0100 Subject: [PATCH 1/3] Correct tailoring for verification process Resolves: #468 Signed-off-by: Philipp Ahmann --- .../release_management/guidance/release_guideline.rst | 2 +- .../release_management/guidance/release_templates.rst | 4 ++-- .../verification/guidance/verification_guideline.rst | 2 +- .../verification/guidance/verification_report_template.rst | 4 ++-- .../process_areas/verification/verification_workproducts.rst | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/process/process_areas/release_management/guidance/release_guideline.rst b/process/process_areas/release_management/guidance/release_guideline.rst index e6f7bf5cbe..28b485c98a 100644 --- a/process/process_areas/release_management/guidance/release_guideline.rst +++ b/process/process_areas/release_management/guidance/release_guideline.rst @@ -18,7 +18,7 @@ Guideline .. gd_guidl:: Release Management Guideline :id: gd_guidl__rel_management :status: valid - :complies: std_req__iso26262__management_64131, std_req__iso26262__management_64132, std_req__iso26262__management_64133, std_req__iso26262__management_64134, std_req__iso26262__management_64135 + :complies: std_req__iso26262__software_1041, std_req__iso26262__management_64131, std_req__iso26262__management_64132, std_req__iso26262__management_64133, std_req__iso26262__management_64134, std_req__iso26262__management_64135 .. _workflow_release: diff --git a/process/process_areas/release_management/guidance/release_templates.rst b/process/process_areas/release_management/guidance/release_templates.rst index 3e412e11ab..cef8a8386f 100644 --- a/process/process_areas/release_management/guidance/release_templates.rst +++ b/process/process_areas/release_management/guidance/release_templates.rst @@ -18,7 +18,7 @@ Templates .. gd_temp:: Platform Release Note Template :id: gd_temp__rel_plat_rel_note :status: valid - :complies: std_req__iso26262__management_64134, std_req__iso26262__management_64135, std_req__aspice_40__SUP-8-BP7 + :complies: std_req__iso26262__software_1041, std_req__iso26262__management_64134, std_req__iso26262__management_64135, std_req__aspice_40__SUP-8-BP7 | Platform Release Notes | ====================== @@ -97,7 +97,7 @@ Templates .. gd_temp:: Module Release Note Template :id: gd_temp__rel_mod_rel_note :status: valid - :complies: std_req__iso26262__management_64134, std_req__iso26262__management_64135 + :complies: std_req__iso26262__software_1041, std_req__iso26262__management_64134, std_req__iso26262__management_64135 For the content see here: :need:`doc__module_name_release_note` diff --git a/process/process_areas/verification/guidance/verification_guideline.rst b/process/process_areas/verification/guidance/verification_guideline.rst index da2437d488..b85f7f6bb4 100644 --- a/process/process_areas/verification/guidance/verification_guideline.rst +++ b/process/process_areas/verification/guidance/verification_guideline.rst @@ -142,7 +142,7 @@ Tailoring :id: gd_guidl__verification_req_tailored :status: valid :complies: std_req__iso26262__software_945, - std_req__iso26262__software_1041, std_req__iso26262__software_1045, std_req__iso26262__software_1046, std_req__iso26262__software_1047, + std_req__iso26262__software_1045, std_req__iso26262__software_1046, std_req__iso26262__software_1047, std_req__iso26262__software_1141, std_req__iso26262__software_1142, std_req__iso26262__software_1143, std_req__iso26262__software_1144 This part of the guideline links to all the requirements which are not fulfilled by the diff --git a/process/process_areas/verification/guidance/verification_report_template.rst b/process/process_areas/verification/guidance/verification_report_template.rst index 47ae121abe..59c8ce6694 100644 --- a/process/process_areas/verification/guidance/verification_report_template.rst +++ b/process/process_areas/verification/guidance/verification_report_template.rst @@ -21,7 +21,7 @@ Verification Report Templates :id: gd_temp__mod_ver_report :status: valid :complies: std_req__iso26262__software_942, std_req__iso26262__software_943, std_req__iso26262__software_944, - std_req__iso26262__software_1042, std_req__iso26262__software_1043, + std_req__iso26262__software_1041, std_req__iso26262__software_1042, std_req__iso26262__software_1043, std_req__iso26262__support_9431, std_req__iso26262__support_9432, std_req__iso26262__support_9433, std_req__iso26262__support_9434, std_req__iso26262__support_12422, std_req__iso26262__support_12423, std_req__iso26262__support_12424, std_req__iso26262__support_12425, std_req__iso26262__support_1243, @@ -97,7 +97,7 @@ Verification Report Templates .. gd_temp:: Platform Verification Report Template :id: gd_temp__platform_ver_report :status: valid - :complies: std_req__iso26262__software_1042, std_req__iso26262__software_1044, + :complies: std_req__iso26262__software_1041, std_req__iso26262__software_1042, std_req__iso26262__software_1044, std_req__iso26262__support_9431, std_req__iso26262__support_9432, std_req__iso26262__support_9433, std_req__iso26262__support_9434, std_req__iso26262__analysis_749, std_req__iso26262__analysis_848 diff --git a/process/process_areas/verification/verification_workproducts.rst b/process/process_areas/verification/verification_workproducts.rst index f7aca91fc6..515780d593 100644 --- a/process/process_areas/verification/verification_workproducts.rst +++ b/process/process_areas/verification/verification_workproducts.rst @@ -88,7 +88,7 @@ Module .. workproduct:: Module Verification Report :id: wp__verification_module_ver_report :status: valid - :complies: std_wp__iso26262__software_952, std_wp__iso26262__software_1053, std_wp__iso26262__support_953, std_wp__iso26262__support_1253, std_wp__iso26262__analysis_752, std_wp__iso26262__analysis_852, std_wp__iso26262__support_1252, std_wp__isopas8926__4526, std_wp__iso26262__software_app_c_56 + :complies: std_wp__iso26262__software_952, std_req__iso26262__software_1041, std_wp__iso26262__software_1053, std_wp__iso26262__support_953, std_wp__iso26262__support_1253, std_wp__iso26262__analysis_752, std_wp__iso26262__analysis_852, std_wp__iso26262__support_1252, std_wp__isopas8926__4526, std_wp__iso26262__software_app_c_56 Verification Report contains: From d30f4a6c7dc14b115b5f47b9090d811ce3a6a2e3 Mon Sep 17 00:00:00 2001 From: Philipp Ahmann Date: Thu, 18 Dec 2025 15:16:10 +0100 Subject: [PATCH 2/3] Add integration dependencies req to release handbook Signed-off-by: Philipp Ahmann --- .../guidance/release_guideline.rst | 27 ++++++++++++++++++- .../guidance/release_templates.rst | 4 +-- .../release_management/release_workflow.rst | 2 +- .../verification_workproducts.rst | 2 +- 4 files changed, 30 insertions(+), 5 deletions(-) diff --git a/process/process_areas/release_management/guidance/release_guideline.rst b/process/process_areas/release_management/guidance/release_guideline.rst index 28b485c98a..c65dc9d2f3 100644 --- a/process/process_areas/release_management/guidance/release_guideline.rst +++ b/process/process_areas/release_management/guidance/release_guideline.rst @@ -85,6 +85,7 @@ Platform Release * Prepare platform release notes summarizing the updates from all integrated software modules. * Check if all planned configuration items are in correct state (i.e. work products are valid, external libraries/tools are used in the correct released version). * Ensure the relevant safety packages are available and complete. + * Create/Maintain Platform Handbook for the release. * Tag the platform release in the repository. 5. **Release Execution**: @@ -110,10 +111,34 @@ Tracking and Communication * meeting definition and schedule is defined in the projects's platform management plan, as defined in :need:`gd_guidl__platform_mgmt_plan`. +.. gd_guidl:: Release Handbook + :id: gd_guidl__rel_handbook + :status: valid + :complies: std_req__iso26262__software_1041 + + Release Handbook + ---------------- + + The release handbook incorporates an overview including a tutorial to explain the usage of the released software. + It extends as a decent documentation for users and contributors beyond the pure release notes created according to the template :need:`gd_temp__rel_plat_rel_note`. + + It is intended to contain: + + * Overview of the technologies used within the project + * Software architecture overview + * Module structure overview + * Integration process + * Getting started guide + * Contribution guide + + By this the software integration approach becomes clear and reflects the dependencies and functional unit integration of the various modules. + It also describes how to build and run the software for the various target systems such as simulation, hardware architectures, and operating system(s). + + Templates ========= -For the release note a template has been created for module level and for platform level +For the release note a template has been created for module level and for platform level. .. list-table:: Overview :header-rows: 1 diff --git a/process/process_areas/release_management/guidance/release_templates.rst b/process/process_areas/release_management/guidance/release_templates.rst index cef8a8386f..3e412e11ab 100644 --- a/process/process_areas/release_management/guidance/release_templates.rst +++ b/process/process_areas/release_management/guidance/release_templates.rst @@ -18,7 +18,7 @@ Templates .. gd_temp:: Platform Release Note Template :id: gd_temp__rel_plat_rel_note :status: valid - :complies: std_req__iso26262__software_1041, std_req__iso26262__management_64134, std_req__iso26262__management_64135, std_req__aspice_40__SUP-8-BP7 + :complies: std_req__iso26262__management_64134, std_req__iso26262__management_64135, std_req__aspice_40__SUP-8-BP7 | Platform Release Notes | ====================== @@ -97,7 +97,7 @@ Templates .. gd_temp:: Module Release Note Template :id: gd_temp__rel_mod_rel_note :status: valid - :complies: std_req__iso26262__software_1041, std_req__iso26262__management_64134, std_req__iso26262__management_64135 + :complies: std_req__iso26262__management_64134, std_req__iso26262__management_64135 For the content see here: :need:`doc__module_name_release_note` diff --git a/process/process_areas/release_management/release_workflow.rst b/process/process_areas/release_management/release_workflow.rst index 7d443189fb..94edd790ae 100644 --- a/process/process_areas/release_management/release_workflow.rst +++ b/process/process_areas/release_management/release_workflow.rst @@ -77,7 +77,7 @@ For a detailed explanation of workflows and their role within the process model, :approved_by: rl__project_lead :input: wp__platform_safety_package, wp__platform_sw_release_plan, wp__verification_platform_ver_report :output: wp__platform_handbook - :contains: + :contains: gd_guidl__rel_handbook :has: doc_concept__rel_process, doc_getstrt__release_process The platform handbook is prepared and approved by the project lead circle. diff --git a/process/process_areas/verification/verification_workproducts.rst b/process/process_areas/verification/verification_workproducts.rst index 515780d593..f7aca91fc6 100644 --- a/process/process_areas/verification/verification_workproducts.rst +++ b/process/process_areas/verification/verification_workproducts.rst @@ -88,7 +88,7 @@ Module .. workproduct:: Module Verification Report :id: wp__verification_module_ver_report :status: valid - :complies: std_wp__iso26262__software_952, std_req__iso26262__software_1041, std_wp__iso26262__software_1053, std_wp__iso26262__support_953, std_wp__iso26262__support_1253, std_wp__iso26262__analysis_752, std_wp__iso26262__analysis_852, std_wp__iso26262__support_1252, std_wp__isopas8926__4526, std_wp__iso26262__software_app_c_56 + :complies: std_wp__iso26262__software_952, std_wp__iso26262__software_1053, std_wp__iso26262__support_953, std_wp__iso26262__support_1253, std_wp__iso26262__analysis_752, std_wp__iso26262__analysis_852, std_wp__iso26262__support_1252, std_wp__isopas8926__4526, std_wp__iso26262__software_app_c_56 Verification Report contains: From 264bb81ecea12a33967b01066fa61d20ad66be2a Mon Sep 17 00:00:00 2001 From: Philipp Ahmann Date: Thu, 18 Dec 2025 15:27:49 +0100 Subject: [PATCH 3/3] Resolve indention build doc build issue Signed-off-by: Philipp Ahmann --- .../release_management/guidance/release_guideline.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/process/process_areas/release_management/guidance/release_guideline.rst b/process/process_areas/release_management/guidance/release_guideline.rst index c65dc9d2f3..4d3b97959b 100644 --- a/process/process_areas/release_management/guidance/release_guideline.rst +++ b/process/process_areas/release_management/guidance/release_guideline.rst @@ -110,15 +110,14 @@ Tracking and Communication * Hold periodic meetings to discuss progress, issues, and dependencies within the project lead circle. * meeting definition and schedule is defined in the projects's platform management plan, as defined in :need:`gd_guidl__platform_mgmt_plan`. +Release Handbook +---------------- .. gd_guidl:: Release Handbook :id: gd_guidl__rel_handbook :status: valid :complies: std_req__iso26262__software_1041 - Release Handbook - ---------------- - The release handbook incorporates an overview including a tutorial to explain the usage of the released software. It extends as a decent documentation for users and contributors beyond the pure release notes created according to the template :need:`gd_temp__rel_plat_rel_note`.