Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
fe406a3
2501 attifunel: added missing templates
attifunel Feb 18, 2026
29e1c86
2501 attifunel: added missing templates
attifunel Feb 18, 2026
40fff37
2501 attifunel: fixed index errors
attifunel Feb 18, 2026
3771829
2501 attifunel fixed hopefully last index error
attifunel Feb 18, 2026
5f5a7d3
Fix build issues created during merge
pahmann Feb 18, 2026
7e2f74f
issue 574 attifunel fixed comments from review
attifunel Feb 18, 2026
fd7d079
issue 2501 attifunel fixed python version in bazel file
attifunel Feb 18, 2026
71d6d7c
issue 2501 attifunel fixed missing link
attifunel Feb 19, 2026
4f274e7
issue 2501 attifunel fixing "platform name"-type link
attifunel Feb 19, 2026
869c578
issue 2501 attifunel fixed further comments
attifunel Feb 19, 2026
43a0c3a
2501 attifunel fixed further review comments
attifunel Feb 24, 2026
4b38fad
2501 attifunel: fixed build errors
attifunel Feb 24, 2026
a3d98f7
2501 attifunel fixed errors and further comments
attifunel Feb 24, 2026
d5b1c1b
2501 attifunel try to fix again ref error
attifunel Feb 24, 2026
5025764
2501 attifunel try to fix again ref error
attifunel Feb 24, 2026
e5a96b3
2501 attifunel fixed duplicate ver. rep. templates
attifunel Feb 24, 2026
91b404d
2501 attifunel fixed duplicate ver. rep. templates
attifunel Feb 24, 2026
3bc0443
2501 fix links from guidance to templates
attifunel Feb 24, 2026
86888d5
2501 fixing wrong links again
attifunel Feb 24, 2026
5933c74
2501 fixing further indent problems
attifunel Feb 24, 2026
72fbd0d
2501 fixing further indent and links problems
attifunel Feb 24, 2026
29ccfcf
2501 fixed copypaste error
attifunel Feb 24, 2026
e03e8a3
2501 fixing wrong doc id
attifunel Feb 24, 2026
d9121af
2501 fixing ambiguity in Safety Analyses
attifunel Feb 24, 2026
1f5c67c
2501 some fixes at verification report template
attifunel Feb 24, 2026
f3a7389
2501 fixed indent error
attifunel Feb 24, 2026
a222164
fixing merging conflicts + further comments
attifunel Feb 26, 2026
2d89802
fixed header subtitle in RN
attifunel Feb 26, 2026
184a597
fixed subtitle
attifunel Feb 26, 2026
37f0b17
fixed duplicate header
attifunel Feb 26, 2026
8f15d3c
fixing indentation
attifunel Feb 26, 2026
be7572c
fixing indentation
attifunel Feb 26, 2026
dcfbbc8
trying to fix indent issues
attifunel Feb 26, 2026
42cbb51
restored 6. and 7. of module verification report
attifunel Feb 26, 2026
2ebdd52
2501 attifunel last (hopefully) fixes from review + stakeholder/featu…
attifunel Mar 3, 2026
df8ff68
added another file
attifunel Mar 3, 2026
f3d1d32
index.rst corrections
attifunel Mar 3, 2026
98f3ffa
fix regex expression
attifunel Mar 3, 2026
0e2f708
fix last regex error
attifunel Mar 3, 2026
e6bdf05
align security and safety management templates
pahmann Mar 3, 2026
a9abcd5
Fix a typo
pahmann Mar 3, 2026
6268a61
fixed review comments
attifunel Mar 4, 2026
1b41b2c
Add missing docs to index
pahmann Mar 4, 2026
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
2 changes: 1 addition & 1 deletion MODULE.bazel
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ bazel_dep(name = "rules_pkg", version = "1.1.0")
# Python version
#
###############################################################################
bazel_dep(name = "rules_python", version = "1.4.1")
bazel_dep(name = "rules_python", version = "1.8.3")

PYTHON_VERSION = "3.12"

Expand Down
4 changes: 2 additions & 2 deletions process/folder_templates/features/feature_name/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
:id: doc__feature_name
:status: draft
:safety: ASIL_B
:security: NO
:security: YES
:realizes: wp__feat_request
:tags: template

Expand All @@ -33,7 +33,7 @@
- Modify ``document`` to be your Feature Name
- Modify ``id`` to be your Feature Name in upper snake case preceded by ``doc__``
- Adjust ``status`` to be ``valid``
- Adjust ``safety`` and ``tags`` according to your needs
- Adjust ``safety``, ``security`` and ``tags`` according to your needs

Feature flag
============
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@
# SPDX-License-Identifier: Apache-2.0
# *******************************************************************************

Requirements
############
Feature Requirements
####################

.. document:: [Your Feature Name] Requirements
:id: doc__feature_name_requirements
Expand All @@ -34,25 +34,14 @@ Requirements
<Headlines (for the list of requirements if structuring is needed)>
===================================================================

.. stkh_req:: Template
:id: stkh_req__requirements__template
:reqtype: Non-Functional
:safety: ASIL_B
:security: YES
:rationale: Exists just for the template example
:status: invalid

The platform shall ...

.. attention::
The above stakeholder requirement must be removed, it just serves as a link target for this template.

.. feat_req:: Some Title
:id: feat_req__feature_name__some_title
:reqtype: Process
:security: YES
:security: NO
:safety: ASIL_B
:satisfies: stkh_req__requirements__template
:valid_from: v0.0.1
:valid_until: v1.0.1
:status: invalid
:belongs_to: feat__feature_name

Expand All @@ -63,7 +52,7 @@ Requirements
.. aou_req:: Some Other Title
:id: aou_req__feature_name__some_other_title
:reqtype: Process
:security: YES
:security: NO
:safety: ASIL_B
:status: invalid

Expand All @@ -73,8 +62,13 @@ Requirements
The above directives must be updated according to your feature requirements.

- Replace the example content by the real content for your first requirement (according to :need:`gd_guidl__req_engineering`)
- Set the status to valid and start the review/merge process
- Set ``belongs_to`` with a link to feature ID
- Set ``reqtype`` with a link to the right value (<Functional|Interface|Process|Non-Functional>)
- Set ``satisfies`` with a link to the right stakeholder requirement
- Adjust ``safety`` and ``security`` to the right value (ASIL B/QM; YES/NO)
- Add other needed requirements for your feature
- Adjust ``valid_from`` and ``valid_until`` to the right version numbers
- Set ``status`` to ``valid`` and start the review/merge process

.. needextend:: docname is not None and "feature_name" in id
:+tags: feature_name
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Requirements
:id: doc__component_name_requirements
:status: draft
:safety: ASIL_B
:security: NO
:security: YES
:realizes: wp__requirements_comp
:tags: template

Expand All @@ -29,7 +29,7 @@ Requirements
- Modify ``Your Component Name`` to be your Component Name
- Modify ``id`` to be your Component Name in upper snake case preceded by ``doc__`` and followed by ``_requirements``
- Adjust ``status`` to be ``valid``
- Adjust ``safety`` and ``tags`` according to your needs
- Adjust ``safety``, ``security`` and ``tags`` according to your needs

<Headlines (for the list of requirements if structuring is needed)>
===================================================================
Expand All @@ -54,6 +54,9 @@ Component Requirements
The above directive must be updated according to your component requirements.

- Replace the example content by the real content for your first requirement
- Set ``satistifes`` with links to Feature requirements
- Set ``belongs_to`` with a link to the right Component id
- Set ``safety`` and ``security`` to the right value
- Set the status to valid and start the review/merge process
- Add other needed requirements for your component

Expand All @@ -67,7 +70,7 @@ Assumption of Use Requirements
:safety: ASIL_B
:status: invalid

The Component User shall do xyz to use the component safely
The Component User shall do xyz to use the component safely/securely

Environmental Requirements
--------------------------
Expand All @@ -89,8 +92,10 @@ Hints
The above directives must be updated according to your feature requirements.

- Replace the example content by the real content for your first requirement (according to :need:`gd_guidl__req_engineering`)
- Set the status to valid and start the review/merge process
- Set ``safety`` and ``security`` to the right value (ASIL B/QM; YES/NO)
- Set ``reqtype`` with a link to the right value (<Functional|Interface|Process|Non-Functional>)
- Add other needed requirements for your feature
- Set ``status`` to ``valid`` and start the review/merge process

.. needextend:: "component_name" in id
:+tags: component_name
Original file line number Diff line number Diff line change
Expand Up @@ -122,9 +122,6 @@ Release Note
| Contributor 1
| Contributor 2
|

---

| Contact Information
| -------------------
|
Expand Down
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
..
# *******************************************************************************
# 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
# *******************************************************************************

Security Management
###################

.. toctree::
:titlesonly:

module_security_plan
module_security_plan_fdr
module_security_package_fdr
..
# *******************************************************************************
# Copyright (c) 2026 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
# *******************************************************************************
Security Management
###################
.. toctree::
:titlesonly:
module_security_plan
module_security_plan_fdr
module_security_package_fdr
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,6 @@ Verification Report
- Adjust ``status`` to be ``valid``
- Adjust ``safety`` and ``tags`` according to your needs


This verification report is based on the :need:`gd_temp__verification_plan`.
It covers all the components of the above stated module.

Expand Down Expand Up @@ -86,6 +85,12 @@ Verification Report contains:
**5. Software component qualification verification report**
- Contains the needed verification results if for some components a qualification of pre-developed SW is performed.

**6. Test results**
- Test result per test case with status passed/failed/not_run

**7. Test logs**
- Test log per test case with status passed/failed/not_run

**Note1:** The verification report is valid for the module version tagged together with the report

**Note2:** All the above lists are generated automatically
121 changes: 121 additions & 0 deletions process/folder_templates/platform/docs/release/release_note.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
..
# *******************************************************************************
# 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
# *******************************************************************************

Platform Release Note
=====================

.. note:: Document header

.. document:: Platform Release Note
:id: doc__platform_release_note
:status: draft
:safety: ASIL_B
:security: NO
Copy link
Contributor

Choose a reason for hiding this comment

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

In general, why did you remove Security: YES and let safety to ASIL_B? Please set both so user must actively set NO or QM, if needed. Not everything is safety: ASIL_B by default.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

In other templates it is always Safety ASIL B, security NO. In general this is just an example, I added a specific request below to set the required values

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Anyway I think I fixed

:realizes: wp__platform_sw_release_note
:tags: template

.. attention::
The above directive must be updated.

- Adjust ``status`` to be ``valid``
- Adjust ``safety`` and ``tags`` according to your needs



| Release Tag: vX.Y.Z
| Origin Release Tag: vU.V.W
| Release Commit Hash: a1b2c3d4e5f6g7h8i9j0
| Release Date: YYYY-MM-DD
| Safety: [QM | ASIL_B]
| Security: [NO | YES]
|
| Overview
| --------
|
| This document provides an overview of the changes, improvements, and bug fixes included in the software platform release version vX.Y.Z
| as compared to the platform's origin release (which is usually the previous release).
|
| Disclaimer
| ----------
| This release note does not "release for production", as it does not come with a safety argumentation and a performed safety assessment.
| The work products compiled in the safety package are created with care according to a process satisfying standards, but the as the project,
| being a non-profit and open source organization, can not take over any liability for its content.
|
| New Features
| ------------
|
| - **Feature 1**: Brief description of the new feature.
| - **Feature 2**: Brief description of the new feature.
| - **Feature 3**: Brief description of the new feature.
|
| Improvements
| ------------
|
| - **Improvement 1**: Brief description of the improvement.
| - **Improvement 2**: Brief description of the improvement.
| - **Improvement 3**: Brief description of the improvement.
|
| Bug Fixes
| ---------
|
| - **Bug 1**: Brief description of the bug fix.
| - **Bug 2**: Brief description of the bug fix.
| - **Bug 3**: Brief description of the bug fix.
|
| Other changes by Label
| ----------------------
|
| - **Label 1/Refactor 1**: Brief description of the change.
| - **Label 2/Refactor 2**: Brief description of the change.
| - **Label 3/Refactor 3**: Brief description of the change.
|
| Compatibility
| -------------
|
| - **Dependencies**: List any dependencies and their versions.
|
| Performed Verification
| ----------------------
| This release note is based on the verification as documented in platform verification report
| :need:`doc__platform_verification_report`.
|
| Known Issues
| ------------
|
| - **Issue 1**: Brief description of the known issue. Justification regarding safety impact.
| - **Issue 2**: Brief description of the known issue. Justification regarding safety impact.
| - **Issue 3**: Brief description of the known issue. Justification regarding safety impact.
|
| Known Vulnerabilities
| ---------------------
|
| - **CVE 1**: Brief description of the known CVE. Justification regarding security impact.
| - **CVE 2**: Brief description of the known CVE. Justification regarding security impact.
| - **CVE 3**: Brief description of the known CVE. Justification regarding security impact.
|
| Upgrade Instructions
| --------------------
|
| 1. **Step 1**: Description of the first step.
| 2. **Step 2**: Description of the second step.
| 3. **Step 3**: Description of the third step.
|
| Contributors
| ------------
|
| Thanks to everyone who contributed to this release:
|
| Contributor 1
| Contributor 2
|
26 changes: 26 additions & 0 deletions process/folder_templates/platform/docs/safety_mgt/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
..
# *******************************************************************************
# Copyright (c) 2026 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
# *******************************************************************************

Safety Management
#################

.. toctree::
:titlesonly:

platform_dfa
platform_safety_manual
platform_safety_plan_fdr
platform_safety_package_fdr
platform_safety_analysis_fdr
platform_safety_plan
Original file line number Diff line number Diff line change
Expand Up @@ -29,13 +29,6 @@ Platform DFA (Dependent Failure Analysis)

.. note:: Use the content of the document to describe e.g. why a fault model is not applicable for the diagram.

.. attention::
The above directive must be updated according to your Feature.

- Modify ``Your Feature Name`` to be your Feature Name
- Modify ``id`` to be your Feature Name in upper snake case preceded by ``doc__`` and succeeded by ``_dfa``
- Adjust ``status`` to be ``valid``
- Adjust ``safety`` and ``tags`` according to your needs

Dependent Failure Initiators
----------------------------
Expand All @@ -44,10 +37,10 @@ Dependent Failure Initiators

.. plat_saf_dfa:: <Title>
:violates: <Feature architecture>
:id: plat_saf_DFA__<Feature>__<Element descriptor>
:id: plat_saf_DFA__Platform__<Element descriptor>
:failure_id: <ID from DFA failure initiators :need:`gd_guidl__dfa_failure_initiators`>
:failure_effect: "description of failure effect of the failure initiator on the element"
:mitigated_by: <ID from Feature Requirement | ID from AoU Feature Requirement>
:mitigated_by: <ID from Stakeholder Requirement | ID from AoU Feature Requirement>
:mitigation_issue: <ID from Issue Tracker>
:sufficient: <yes|no>
:status: <valid|invalid>
Expand Down
Loading
Loading