Skip to content

process introduction explanation #424

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
masc2023 merged 17 commits into from
Dec 1, 2025
Merged

process introduction explanation #424

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
e10101c
process introduction explanation
RolandJentschETAS Dec 1, 2025
ec90e14
add links from workflows
RolandJentschETAS Dec 1, 2025
cc4327c
correct chapter order
RolandJentschETAS Dec 1, 2025
ff626d9
restore previous version to prevent merge conflict
RolandJentschETAS Dec 1, 2025
8f0b390
add wp as input
RolandJentschETAS Dec 1, 2025
c13b8cb
fix header lengths
RolandJentschETAS Dec 1, 2025
b8c9824
Merge branch 'main' into proper_general_workflow_description
RolandJentschETAS Dec 1, 2025
1d05c55
adjust picture
RolandJentschETAS Dec 1, 2025
f2add6a
remove hint to eclipse
RolandJentschETAS Dec 1, 2025
16acdbc
caption naming
RolandJentschETAS Dec 1, 2025
7bfcb78
caption naming
RolandJentschETAS Dec 1, 2025
4ec8283
bound guidance together
RolandJentschETAS Dec 1, 2025
a88e54d
add hint for project roles list
RolandJentschETAS Dec 1, 2025
81401a7
add hint for coverage
RolandJentschETAS Dec 1, 2025
0be4e09
spelling
RolandJentschETAS Dec 1, 2025
440c1eb
spelling
RolandJentschETAS Dec 1, 2025
f84c6b7
spelling
RolandJentschETAS Dec 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions process/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Workflow activities are supported by guidances.
General Concepts
~~~~~~~~~~~~~~~~

General concepts like traceability of work products, life cycle model, building blocks can be found here:
The general concepts like traceability of work products, life cycle model, building blocks can be found here:

.. toctree::
:maxdepth: 1
Expand All @@ -64,7 +64,7 @@ The process description for the project (e.g. requirements, architecture, safety
Process Role definition
~~~~~~~~~~~~~~~~~~~~~~~

General roles not part of any process area.
The general roles that are not part of any process area can be found here:

.. toctree::
:maxdepth: 1
Expand All @@ -74,7 +74,7 @@ General roles not part of any process area.
Work Products
~~~~~~~~~~~~~

General work products not part of any process area and work product overview list.
The general work products that are not part of any process area and the work product overview list can be found here:

.. toctree::
:maxdepth: 1
Expand All @@ -84,7 +84,7 @@ General work products not part of any process area and work product overview lis
Workflows
~~~~~~~~~

General workflows not part of any process area and workflow overview list.
The general workflows that are not part of any process area and workflow overview list can be found here:

.. toctree::
:maxdepth: 1
Expand All @@ -94,7 +94,7 @@ General workflows not part of any process area and workflow overview list.
Standards
---------

The the standard references the project's processes are derived from can be found here:
The standard references the project's processes are derived from can be found here:

.. toctree::
:maxdepth: 1
Expand Down
982 changes: 978 additions & 4 deletions process/introduction/_assets/score_process_model.drawio.svg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
31 changes: 23 additions & 8 deletions process/introduction/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,16 +28,19 @@ Introduction

Motivation
----------
| The process model aims to establish organization rules for developing
| open source software in the automotive industry, which can be used in safety and security context.

The process model aims to establish organization rules for developing
open source software in the automotive industry, which can be used in safety and security context.

Objectives
----------
| The process model shall provide processes, which conform to state-of the art standards
| * ASPICE
| * ISO 26262
| * ISO 21434
| * ISO PAS 8926

The process model shall provide processes, which conform to state-of the art standards

* :ref:`ASPICE<standard_aspice_pam4>`
* :ref:`ISO 26262<standard_iso26262>`
* :ref:`ISO 21434<standard_isosae21434>`
* :ref:`ISO PAS 8926<standard_isopas8926>`

Approach
--------
Expand All @@ -47,7 +50,7 @@ Approach
3. We aim to develop the process in conformance to the targeted standards (compare figure below).
4. We aim to establish traceability from the begin (compare :ref:`general_concepts_traceability`).
5. We aim to verify conformity and traceability by tool automation as much as possible (compare figure below).
6. We aim for an iterative collaboration model initiated by change requests (compare :need:`gd_guidl__change_change_request`)
6. We aim for an iterative collaboration model initiated by change requests (compare :need:`gd_guidl__change_change_request`).


.. figure:: _assets/score_process_model.drawio.svg
Expand All @@ -56,3 +59,15 @@ Approach
:alt: Overview process model

Overview process model

The process model is structured around the concept of :ref:`workflows<workflows>`, which form the core of each :ref:`process<process_areas>`. Each workflow defines the sequence of activities required to achieve specific objectives within the project. The activities linked from these workflows are directly linked to roles, ensuring that responsibilities and accountabilities are clearly assigned throughout the process.

Workflows also establish connections to :ref:`work products<work_products>`, which are the tangible outputs or artifacts generated during process execution. Each work product is associated with or requested by relevant :ref:`standards<external_standards>` and :ref:`requirements<process_req>` of these standards, ensuring compliance and traceability.
Copy link
Contributor

@masc2023 masc2023 Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we also add, that work products are inputs? If yes, we may consider to adapt image also

Copy link
Contributor Author

@RolandJentschETAS RolandJentschETAS Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, we should state it. Should we add another arrow in the picture or make the line with arrows and text on both sides ?

Copy link
Contributor

@masc2023 masc2023 Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could be one line with arrows, as text should be the same on bot sides

Copy link
Contributor Author

@RolandJentschETAS RolandJentschETAS Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


To facilitate onboarding and understanding, the process model provides dedicated sections for a "Getting Started", a detailed "Concept Description", and comprehensive guideline (within the "Guidance" section) for each process. These resources help Contributors, Committers and other Users quickly familiarize themselves with the process, understand key concepts, and apply best practices throughout process execution and should be read in this order. See :need:`Requirements process getting started<doc_getstrt__req_process>`, :need:`Requirement concept description<doc_concept__req_process>` and :need:`Requirement process guideline<gd_guidl__req_engineering>` as examples.

The model further integrates :ref:`templates<folder_templates>`, checklists (see :need:`requirement inspection checklist<doc__feature_name_req_inspection>` as example) and methods (see :need:`verification methods<gd_meth__verification_methods>` as example) to support the consistent and efficient execution of processes.
Copy link
Contributor

@masc2023 masc2023 Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Guideline are also supporting according to the model

Copy link
Contributor Author

@RolandJentschETAS RolandJentschETAS Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have it see the first sentence. "... and comprehensive guideline (within the "Guidance" section) for each process." Should I explain that more ?

Copy link
Contributor

@masc2023 masc2023 Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mean only, should be moved to the next section, where methodes, etc. are mentioned, compare overview image, is part of the big box guidance

Copy link
Contributor Author

@RolandJentschETAS RolandJentschETAS Dec 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. Please have a look.


Additionally, the process model incorporates traceability mechanisms, allowing for the verification of conformity to standards such as ASPICE, ISO 26262, and others. The relationships between workflows, roles, work products, and supporting materials are visualized in the process model diagram above, providing a clear overview of how all elements interact to support process development and continuous improvement within the organization.

The process model follows a code-centric, iterative approach that establishes :ref:`traceability<general_concepts_traceability>` according to the :ref:`meta model of the building blocks<general_concepts_building_blocks>` from the beginning and leverages tool automation to verify conformity and traceability as much as possible. Tools are evaluated and :ref:`qualified<tools_template>` by Committers, used by Contributors to execute workflows, and must fulfill defined process requirements to support efficient and compliant process execution.
6 changes: 4 additions & 2 deletions process/process_areas/architecture_design/architecture_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,10 @@

.. _arch_workflow:

Architecture Workflow
=====================
Architecture Workflows
######################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create/Maintain Feature architecture
:id: wf__cr_mt_featarch
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/change_management/change_management_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,10 @@

.. _chm_change_workflows:

Workflow Change Management
##########################
Change Management Workflows
###########################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create Change Request
:id: wf__change_create_cr
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/change_management/change_management_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Change Management
Change Management Work Products
###############################

.. workproduct:: Platform Change Management Plan
Expand Down
4 changes: 3 additions & 1 deletion process/process_areas/configuration_management/configuration_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,11 @@
# *******************************************************************************


Workflows Configuration Management
Configuration Management Workflows
##################################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

The main work product is the configuration management plan, which is a part of the platform management plan.
Thus the work flow :need:`wf__platform_cr_mt_platform_mgmt_plan` applies.

Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/configuration_management/configuration_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Configuration Management
Configuration Management Work Products
######################################

.. workproduct:: Platform Configuration Management Plan
Expand Down
5 changes: 3 additions & 2 deletions process/process_areas/documentation_management/documentation_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,11 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************


Workflow Documentation Management
Documentation Management Workflow
#################################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

The main work product is the documentation management plan, which is a part of the platform
management plan. Thus the work flow :need:`wf__platform_cr_mt_platform_mgmt_plan` applies.

Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/documentation_management/documentation_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Documentation Management
Documentation Management Work Products
######################################

.. workproduct:: Documentation Management Plan
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/implementation/implementation_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,10 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Workflow Implementation
#######################
Implementation Workflows
########################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create/Maintain Software Development Plan
:id: wf__sw_development_plan
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/implementation/implementation_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Workproducts Implementation
Implementation Workproducts
###########################

.. workproduct:: Implementation
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/platform_management/platform_management_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,10 @@

.. _workflow_platform_management:

Workflow Platform Management
############################
Platform Management Workflows
#############################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create/Maintain Platform Management Plan
:id: wf__platform_cr_mt_platform_mgmt_plan
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/platform_management/platform_management_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Platform Management
Platform Management Work Products
#################################

.. workproduct:: Platform Management Plan
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/problem_resolution/problem_resolution_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,10 @@

.. _problem_workflows:

Workflow Problem Resolution
###########################
Problem Resolution Workflows
############################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create Problem Report
:id: wf__problem_create_pr
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/problem_resolution/problem_resolution_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Problem Resolution
Problem Resolution Work Products
################################

.. workproduct:: Platform Problem Resolution Plan
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/process_management/process_management_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,10 @@

.. _process_management_workflows:

Workflow Process Management
###########################
Process Management Workflows
############################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create/Maintain Process Management Strategy
:id: wf__cr_mt_process_mgt_strategy
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/process_management/process_management_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Process Management
Process Management Work Products
################################

.. workproduct:: Process Management Strategy
Expand Down
7 changes: 5 additions & 2 deletions process/process_areas/quality_management/quality_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,11 @@
.. _quality_workflows:

Workflows
---------
Quality Management Workflows
################################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.


.. workflow:: Create/Maintain Quality Management Plan
:id: wf__cr_mt_qlm_plan
Expand Down
4 changes: 2 additions & 2 deletions process/process_areas/quality_management/quality_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Workproducts
############
Quality Management Work Products
################################

.. workproduct:: Quality Management Plan
:id: wp__qms_plan
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/release_management/release_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,10 @@

.. _release_workflows:

Workflow Release Management
###########################
Release Management Workflows
################################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

.. workflow:: Create/Maintain Module Release Note
:id: wf__rel_mod_rel_note
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/release_management/release_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Work Products Release Management
Release Management Work Products
################################

.. workproduct:: Platform Release Notes
Expand Down
7 changes: 5 additions & 2 deletions process/process_areas/requirements_engineering/requirements_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,11 @@
# *******************************************************************************


Workflow Requirements Engineering
#################################
Requirements Engineering Workflows
######################################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.


.. workflow:: Create/Maintain Stakeholder requirements and SW-Platform AoU
:id: wf__req_stkh_req
Expand Down
2 changes: 1 addition & 1 deletion process/process_areas/requirements_engineering/requirements_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************
Workproducts Requirements Engineering
Requirements Engineering Workproducts
#####################################

.. workproduct:: Stakeholder Requirements
Expand Down
6 changes: 4 additions & 2 deletions process/process_areas/safety_analysis/safety_analysis_workflow.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,10 @@

.. _workflow_safety_analysis:

Workflow Safety Analysis
########################
Safety Analysis Workflows
#############################

For a detailed explanation of workflows and their role within the process model, please refer to the :ref:`processes_introduction`.

Safety Analysis is used as a umbrella term for the methods FMEA (Failure Modes and Effects Analysis) and DFA (Dependent Failure Analysis).

Expand Down
4 changes: 2 additions & 2 deletions process/process_areas/safety_analysis/safety_analysis_workproducts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Workproducts Safety Analysis
############################
Safety Analysis Work Products
#############################

.. workproduct:: Platform DFA
:id: wp__platform_dfa
Expand Down
22 changes: 11 additions & 11 deletions process/process_areas/safety_management/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,17 +99,6 @@ In case you are appointed as a :need:`Safety Manager <rl__safety_manager>` by th
* Make familiar with your role description and the other workflows of safety management (see below)
* Make familiar with the development and supporting process descriptions in :ref:`process_description` plus the relevant sections of the :need:`Platform Management Plan <wp__platform_mgmt>`

Workflows
---------

.. toctree::
:maxdepth: 1
:glob:

roles.rst
workproducts.rst
workflows.rst

Guidance
--------

Expand All @@ -121,3 +110,14 @@ Guidance

.. needextend:: docname is not None and "process_areas/safety_management" in docname
:+tags: safety_mgt

Workflows
---------

.. toctree::
:maxdepth: 1
:glob:

roles.rst
workproducts.rst
workflows.rst
Loading
Loading