Improvement: Process requirements alignment

Ref: Resolves: #98

Author: aschemmel-tech

process/general_concepts/score_review_concept.rst

@@ -156,6 +156,7 @@ Process Requirements
 .. gd_req:: Storage of pull requests documentation
    :id: gd_req__general__pull_request_storage
    :status: valid
+   :tags: general
    :complies: std_req__iso26262__support_6433, std_req__iso26262__software_7414
    :satisfies: wf__monitor_verify_requirements, wf__mr_vy_arch
 
@@ -168,6 +169,7 @@ Process Requirements
 .. gd_req:: Hash value for inspected requirements
    :id: gd_req__general__requirements_hash
    :status: valid
+   :tags: general
    :complies: std_req__iso26262__support_6433, std_req__iso26262__software_7414
    :satisfies: wf__monitor_verify_requirements, wf__mr_vy_arch
 
@@ -179,6 +181,7 @@ Process Requirements
 .. gd_req:: Checklist templates in pull requests
    :id: gd_req__general__checklist_templates
    :status: valid
+   :tags: general
    :complies: std_req__iso26262__support_6433, std_req__iso26262__software_7414, std_req__iso26262__software_942
    :satisfies: wf__monitor_verify_requirements, wf__mr_vy_arch
 
@@ -190,6 +193,7 @@ Process Requirements
 .. gd_req:: Status Check
    :id: gd_req__general__status_check
    :status: valid
+   :tags: general
    :complies: std_req__iso26262__support_6433, std_req__iso26262__software_7414
    :satisfies: wf__monitor_verify_requirements, wf__mr_vy_arch
 

process/process_areas/architecture_design/guidance/architecture_process_reqs.rst

@@ -102,10 +102,10 @@ Attributes of Architectural Elements
       * structural element (e.g. some part of the feature tree, component acronym)
       * keyword describing the content of the architectural element
 
-   The naming convention is defined here: `REPLACE_doc__naming_conventions`
+   Check your project's naming conventions (should be called "doc__naming_conventions")
 
 .. gd_req:: Architecture attribute: security
-   :id: gd_req__arch_attr_security
+   :id: gd_req__arch__attr_security
    :status: valid
    :tags: attribute, mandatory
 

process/process_areas/change_management/change_management_workflow.rst

@@ -25,7 +25,7 @@ Workflow Change Management
    :supported_by: rl__technical_lead, rl__module_lead
    :input: wp__policies, wp__issue_track_system, wp__feat_request, wp__cmpt_request
    :output: wp__issue_track_system, wp__feat_request, wp__cmpt_request
-   :contains: gd_guidl__change__change_request, gd_temp__change__feature_request, gd_temp__change__component_request, gd_temp__change__impact_analysis, gd_temp__component_classification, gd_req__change__attr_uid, gd_req__change__attr_status, gd_req__change__attr_title, gd_req__change__attr_impact_description, gd_req__change__attr_impact_safety, gd_req__change__attr_impact_security, gd_req__change__attr_types, gd_req__change__attr_affected_wp, gd_req__change__attr_milestone, gd_req__change_tool_impact_analysis
+   :contains: gd_guidl__change__change_request, gd_temp__change__feature_request, gd_temp__change__component_request, gd_temp__change__impact_analysis, gd_temp__component_classification, gd_req__change__attr_uid, gd_req__change__attr_status, gd_req__change__attr_title, gd_req__change__attr_impact_description, gd_req__change__attr_impact_safety, gd_req__change__attr_impact_security, gd_req__change__attr_types, gd_req__change__attr_affected_wp, gd_req__change__attr_milestone, gd_req__change__tool_impact_analysis
    :has: doc_concept__change__process, doc_getstrt__change__process
 
    The Change Request is created and analyzed.
@@ -49,7 +49,7 @@ Workflow Change Management
    :supported_by: rl__safety_manager, rl__security_manager, rl__quality_manager
    :input: wp__issue_track_system, wp__feat_request, wp__cmpt_request
    :output: wp__issue_track_system, wp__feat_request, wp__cmpt_request
-   :contains: gd_guidl__change__change_request, gd_temp__change__feature_request, gd_temp__change__component_request, gd_temp__change__impact_analysis, gd_temp__component_classification, gd_req__change__attr_uid, gd_req__change__attr_status, gd_req__change__attr_title, gd_req__change__attr_impact_description, gd_req__change__attr_impact_safety, gd_req__change__attr_impact_security, gd_req__change__attr_types, gd_req__change__attr_affected_wp, gd_req__change__attr_milestone, gd_req__change_tool_impact_analysis
+   :contains: gd_guidl__change__change_request, gd_temp__change__feature_request, gd_temp__change__component_request, gd_temp__change__impact_analysis, gd_temp__component_classification, gd_req__change__attr_uid, gd_req__change__attr_status, gd_req__change__attr_title, gd_req__change__attr_impact_description, gd_req__change__attr_impact_safety, gd_req__change__attr_impact_security, gd_req__change__attr_types, gd_req__change__attr_affected_wp, gd_req__change__attr_milestone, gd_req__change__tool_impact_analysis
    :has: doc_concept__change__process, doc_getstrt__change__process
 
    The Change Request is evaluated based on the analysis result either approved, rejected or delayed.

process/process_areas/change_management/guidance/change_management_reqs.rst

@@ -128,7 +128,7 @@ Change Request Checks
 '''''''''''''''''''''
 
 .. gd_req:: Change Requests mandatory attributes provided
-   :id: gd_req__change_attr_mandatory
+   :id: gd_req__change__attr_mandatory
    :status: valid
    :tags: chm, attribute, check
    :satisfies: wf__change__cr_an_change_request, wf__change__rv_ap_change_request
@@ -150,7 +150,7 @@ Change Request Traceability Impact Analysis Tool
 ''''''''''''''''''''''''''''''''''''''''''''''''
 
 .. gd_req:: Change Requests Impact Analysis Tool
-   :id: gd_req__change_tool_impact_analysis
+   :id: gd_req__change__tool_impact_analysis
    :status: valid
    :tags: chm, check, tool
    :satisfies: wf__change__cr_an_change_request, wf__change__rv_ap_change_request

process/process_areas/configuration_management/guidance/process_req.rst

@@ -16,8 +16,9 @@ Configuration Management Process Requirements
 =============================================
 
 .. gd_req:: Permanent Storage
-   :id: gd_req__workproducts_storage
+   :id: gd_req__config__workproducts_storage
    :status: valid
+   :tags: config_mgt
    :complies: std_req__iso26262__support_745, std_req__aspice_40__SUP-8-BP8
 
    At least every platform release shall be stored permanently as a collection of text documents
@@ -29,8 +30,9 @@ Configuration Management Process Requirements
 
 
 .. gd_req:: Baseline Differences
-   :id: gd_req__baseline_diff
+   :id: gd_req__config__baseline_diff
    :status: valid
+   :tags: config_mgt,automated
    :complies: std_req__iso26262__support_741
 
    It shall be possible to show the differences between two baselines.

process/process_areas/documentation_management/guidance/documentation_process_reqs.rst

@@ -18,7 +18,7 @@ Document Management Process Requirements
 ========================================
 
 .. gd_req:: Document Types
-   :id: gd_req__doc_types
+   :id: gd_req__doc__types
    :status: valid
    :complies: std_req__iso26262__support_1043
 
@@ -45,7 +45,7 @@ Document Management Process Requirements
 
 
 .. gd_req:: Document attributes
-   :id: gd_req__doc_attributes
+   :id: gd_req__doc__attributes
    :status: valid
    :complies: std_req__iso26262__support_1043
 
@@ -66,7 +66,7 @@ Document Management Process Requirements
    * reviewer
 
 .. gd_req:: Document Author
-   :id: gd_req__doc_author
+   :id: gd_req__doc__author
    :status: valid
    :complies: std_req__iso26262__support_1045
 
@@ -77,16 +77,16 @@ Document Management Process Requirements
    documentation build for every commit of the file containing the document.
 
 .. gd_req:: Document Reviewer
-   :id: gd_req__doc_reviewer
+   :id: gd_req__doc__reviewer
    :status: valid
    :complies: std_req__iso26262__support_1043
 
    Documents headers shall contain "reviewer" attribute, which is added during documentation build
    and contains only the names of the last PR reviewers, which actually reviewed the file
-   containing the document, which were not covered by :need:`gd_req__doc_approver`.
+   containing the document, which were not covered by :need:`gd_req__doc__approver`.
 
 .. gd_req:: Document Approver
-   :id: gd_req__doc_approver
+   :id: gd_req__doc__approver
    :status: valid
    :complies: std_req__iso26262__support_1045
 

process/process_areas/implementation/guidance/implementation_process_reqs.rst

@@ -16,7 +16,7 @@ Process Requirements
 ####################
 
 .. gd_req:: Static Diagram for Unit Interactions
-   :id: gd_req__static_diagram
+   :id: gd_req__impl__static_diagram
    :status: valid
    :tags: mandatory
    :satisfies: wf__sw_detailed_design
@@ -25,7 +25,7 @@ Process Requirements
    The static diagram shall represent the unit and their relationships using UML notations.
 
 .. gd_req:: Dynamic Diagram for Unit Interactions
-   :id: gd_req__dynamic_diagram
+   :id: gd_req__impl__dynamic_diagram
    :status: valid
    :tags: mandatory
    :satisfies: wf__sw_detailed_design
@@ -34,7 +34,7 @@ Process Requirements
    The dynamic diagram shall represent the unit and their relationships using UML notations.
 
 .. gd_req:: Design to Code Linking
-   :id: gd_req__design_code_link
+   :id: gd_req__impl__design_code_link
    :status: valid
    :tags: mandatory
    :satisfies: wf__sw_detailed_design
@@ -48,7 +48,7 @@ Process Requirements
 
 
 .. gd_req:: Dependency Analysis
-   :id: gd_req__dependency_analysis
+   :id: gd_req__impl__dependency_analysis
    :status: valid
    :satisfies: wf__sw_verify_implementation
    :complies: std_req__iso26262__software_942

process/process_areas/index.rst

@@ -33,3 +33,4 @@ Process Areas
    safety_management/index.rst
    tool_management/index.rst
    verification/index.rst
+   process_management/index.rst

process/process_areas/process_management/index.rst

@@ -0,0 +1,37 @@
+..
+   # *******************************************************************************
+   # Copyright (c) 2025 Contributors to the Eclipse Foundation
+   #
+   # See the NOTICE file(s) distributed with this work for additional
+   # information regarding copyright ownership.
+   #
+   # This program and the accompanying materials are made available under the
+   # terms of the Apache License Version 2.0 which is available at
+   # https://www.apache.org/licenses/LICENSE-2.0
+   #
+   # SPDX-License-Identifier: Apache-2.0
+   # *******************************************************************************
+
+.. _process_mgt:
+
+Process Management
+##################
+
+Disclaimer: this is not the real content, not even the draft content.
+It is used for monitoring/steering our process automation effort.
+
+Automation Status via Process Requirement Table
+***********************************************
+
+All process requirements should be labelled with the priorization of automation implementation:
+
+- A label "manual" means nothing to do, because it must be fulfilled manually (e.g. by filling attributes).
+- A label "done_automation" means nothing to do, because it already works. Note that in docs-as-code repository there are tool requirements linking to the process requirements with an "Implemented" attribute.
+- A label "prio_*_automation" means the prio 1, 2, ... labelled requirement shall be implemented in this order. Prio 1 is everything we need for the re-audit, prio 2 could be done manually as a fallback, prio 3 is nice to have ...
+
+.. needtable::
+   :style: table
+   :types: gd_req
+   :columns: id;status;tags
+   :colwidths: 25,10,25
+   :sort: id

process/process_areas/quality_management/guidance/quality_process_reqs.rst

@@ -16,7 +16,7 @@ Process Requirements
 ====================
 
 .. gd_req:: Quality report automated generation
-   :id: gd_req__qlm_report
+   :id: gd_req__quality__report
    :status: valid
    :tags: quality_management
    :satisfies: wf__mr_imp_qlm_plan_processes