Skip to content

Commit 5ced598

Browse files
authored
Merge pull request #139 from eclipse-score/remove_score
removing s-core and place holder links
2 parents 73d178a + c733134 commit 5ced598

File tree

22 files changed

+101
-110
lines changed

22 files changed

+101
-110
lines changed

process/folder_templates/features/feature_name/safety_planning/index.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,10 @@ Feature Safety Planning
3232
- Adjust ``status`` to be ``valid``
3333
- Adjust ``safety`` and ``tags`` according to your needs
3434

35-
.. list-table:: Feature <feature_name> Workproducts
35+
.. list-table:: Feature <feature_name> Work products
3636
:header-rows: 1
3737

38-
* - Workproduct Id
38+
* - Work product Id
3939
- Link to process
4040
- Process status
4141
- Link to issue

process/folder_templates/modules/module_name/component_name/docs/component_classification.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ Step 2: Determine (C): the uncertainty of finding systematic faults based on the
154154

155155
| (C=1) shall be selected when none of the determined complexity measures indicate HM or NM.
156156
| (C=2) shall be selected when at least one of the determined complexity measures indicate HM or NM, but the gaps evaluated are acceptable, means
157-
| the risk of systematic faults due to these gaps is sufficiently low in the context of S-CORE or manageable by mitigating the gaps.
157+
| the risk of systematic faults due to these gaps is sufficiently low in the context of the project or manageable by mitigating the gaps.
158158
| (C=3) in all other cases.
159159
|
160160

process/folder_templates/modules/module_name/docs/manual/safety_manual.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,16 +38,16 @@ Introduction/Scope
3838
3939
Assumed Platform Safety Requirements
4040
------------------------------------
41-
| For the <S-CORE platform / module name> the following safety related stakeholder requirements are assumed to define the top level functionality (purpose) of the <S-CORE platform / module name>. I.e. from these all the feature and component requirements implemented are derived.
41+
| For the <Project platform / module name> the following safety related stakeholder requirements are assumed to define the top level functionality (purpose) of the <Project platform / module name>. I.e. from these all the feature and component requirements implemented are derived.
4242
| <List here all the stakeholder requirements, with safety not equal to QM, the module's components requirements are derived from.>
4343
4444
Assumptions of Use
4545
------------------
4646

4747
Assumptions on the Environment
4848
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
49-
| Generally the assumption of the S-CORE platform SEooC is that it is integrated in a safe system, i.e. the POSIX OS it runs on is qualified and also the HW related failures are taken into account by the system integrator, if not otherwise stated in the module's safety concept.
50-
| <List here all the OS calls the S-CORE platform expects to be safe.>
49+
| Generally the assumption of the project platform SEooC is that it is integrated in a safe system, i.e. the POSIX OS it runs on is qualified and also the HW related failures are taken into account by the system integrator, if not otherwise stated in the module's safety concept.
50+
| <List here all the OS calls the project platform expects to be safe.>
5151
5252
List of AoUs expected from the environment the platform / module runs on:
5353

@@ -68,7 +68,7 @@ Assumptions on the User
6868
| As there is no assumption on which specific OS and HW is used, the integration testing of the stakeholder and feature requirements is expected to be performed by the user of the platform SEooC. Tests covering all stakeholder and feature requirements performed on a reference platform (tbd link to reference platform specification), reviewed and passed are included in the platform SEooC safety case.
6969
| Additionally the components of the platform may have additional specific assumptions how they are used. These are part of every module documentation: <link to add>. Assumptions from components to their users can be fulfilled in two ways:
7070
| 1. There are assumption which need to be fulfilled by all SW components, e.g. "every user of an IPC mechanism needs to make sure that he provides correct data (including appropriate ASIL level)" - in this case the AoU is marked as "platform".
71-
| 2. There are assumption which can be fulfilled by a safety mechanism realized by some other S-CORE platform component and are therefore not relevant for an user who uses the whole platform. But those are relevant if you chose to use the module SEooC stand-alone - in this case the AoU is marked as "module". An example would be the "JSON read" which requires "The user shall provide a string as input which is not corrupted due to HW or QM SW errors." - which is covered when using together with safe S-CORE platform persistency feature.
71+
| 2. There are assumption which can be fulfilled by a safety mechanism realized by some other project platform component and are therefore not relevant for an user who uses the whole platform. But those are relevant if you chose to use the module SEooC stand-alone - in this case the AoU is marked as "module". An example would be the "JSON read" which requires "The user shall provide a string as input which is not corrupted due to HW or QM SW errors." - which is covered when using together with safe project platform persistency feature.
7272
7373
List of AoUs on the user of the platform features or the module of this safety manual:
7474

process/folder_templates/modules/module_name/docs/release/release_note.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Release Note
4949
| Disclaimer
5050
| ----------
5151
| This release note does not "release for production", as it does not come with a safety argumentation and a performed safety assessment.
52-
| The work products compiled in the safety package are created with care according to a process satisfying standards, but the S-CORE project,
52+
| The work products compiled in the safety package are created with care according to a process satisfying standards, but the as the project,
5353
| being a non-profit and open source organization, can not take over any liability for its content.
5454
|
5555
| New Features

process/folder_templates/modules/module_name/docs/safety_mgt/module_safety_package_fdr.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,14 +48,14 @@ The purpose of this review checklist is to report status of the formal review fo
4848
- Comment
4949

5050
* - 1
51-
- Is a safety package provided which matches the safety plan (i.e. all planned workproducts referenced)?
51+
- Is a safety package provided which matches the safety plan (i.e. all planned work products referenced)?
5252
- [YES | NO ]
5353
- <Rationale for result>
5454

5555
* - 2
5656
- Is the argument how functional safety is achieved, provided in the safety package, plausible and sufficient?
5757
- NO
58-
- The argument is intentionally not provided by S-CORE.
58+
- The argument is intentionally not provided by the project.
5959

6060
* - 3
6161
- Are the referenced work products available?

process/folder_templates/modules/module_name/docs/safety_mgt/module_safety_plan.rst

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Module Safety Plan
3636
Functional Safety Management Context
3737
====================================
3838

39-
This Safety Plan adds to the :ref:`process_safety_management` all the module development relevant workproducts needed for ISO 26262 conformity.
39+
This Safety Plan adds to the :ref:`process_safety_management` all the module development relevant work products needed for ISO 26262 conformity.
4040

4141
Functional Safety Management Scope
4242
==================================
@@ -58,21 +58,21 @@ Tailoring
5858

5959
Additional to the tailoring in the SW platform project as defined in the :ref:`process_safety_management` we define here the additional tailoring on module level.
6060

61-
- Excluded for this module are additionally the following workproducts (and their related requirements):
62-
- <ISO 26262 reference>: <workproduct/requirement> - <Argumentation why it is not needed or replaced by another workproduct or activity.>
61+
- Excluded for this module are additionally the following work products (and their related requirements):
62+
- <ISO 26262 reference>: <work product/requirement> - <Argumentation why it is not needed or replaced by another work product or activity.>
6363

64-
Functional Safety Module Workproducts
65-
=====================================
64+
Functional Safety Module Work products
65+
======================================
6666

67-
One set of workproducts for the module and one set for each component of the module:
67+
One set of work products for the module and one set for each component of the module:
6868

69-
Module Workproducts List
70-
------------------------
69+
Module Work products List
70+
-------------------------
7171

72-
.. list-table:: Module Workproducts
72+
.. list-table:: Module Work products
7373
:header-rows: 1
7474

75-
* - Workproduct Id
75+
* - Work product Id
7676
- Link to process
7777
- Process status
7878
- Link to issue
@@ -122,8 +122,8 @@ Module Workproducts List
122122
- <WP status (manual)>
123123

124124
* - :need:`wp__module_sw_build_config`
125-
- `REPLACE_doc__software_development_plan`
126-
- `copy('status', need_id='REPLACE_doc__software_development_plan')`
125+
- :need:`gd_temp__software_development_plan`
126+
- `copy('status', need_id='gd_temp__software_development_plan')`
127127
- <Link to issue>
128128
- <Link to WP>
129129
- <automated>
@@ -149,13 +149,13 @@ Module Workproducts List
149149
- :need:`doc__module_name_release_note`
150150
- :ndf:`copy('status', need_id='doc__module_name_release_note')`
151151

152-
Component <name> Workproducts List
153-
----------------------------------
152+
Component <name> Work products List
153+
-----------------------------------
154154

155-
.. list-table:: Component <name> Workproducts
155+
.. list-table:: Component <name> Work products
156156
:header-rows: 1
157157

158-
* - Workproduct Id
158+
* - Work product Id
159159
- Link to process
160160
- Process status
161161
- Link to issue
@@ -252,16 +252,16 @@ In case an OSS element is used in the module, part 6 has to be filled out.
252252
OSS (sub-)component qualification plan
253253
======================================
254254

255-
For the selected OSS component the following workproducts will be implemented (and why):
255+
For the selected OSS component the following work products will be implemented (and why):
256256

257257
If the OSS element is classified as a
258258
- component, then the below table shall match the above, adding the reasoning for tailoring of work products according to the OSS component classification.
259-
- lower level component, then no workproducts additional to the component’s will be planned and activities below are part of the component’s issues.
259+
- lower level component, then no work products additional to the component’s will be planned and activities below are part of the component’s issues.
260260

261-
.. list-table:: OSS (sub-)component <name> Workproducts
261+
.. list-table:: OSS (sub-)component <name> Work products
262262
:header-rows: 1
263263

264-
* - Workproduct Id
264+
* - Work product Id
265265
- Link to issue
266266
- Reasoning for tailoring
267267

process/folder_templates/modules/module_name/docs/verification/module_verification_report.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Verification Report
3333
- Adjust ``safety`` and ``tags`` according to your needs
3434

3535

36-
This verification report is based on the `REPLACE_doc__verification_plan`.
36+
This verification report is based on the :need:`gd_temp__verification__plan`.
3737
It covers all the components of the above stated module.
3838

3939
Verification Report contains:

process/general_concepts/score_building_blocks_concept.rst

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -21,16 +21,16 @@ Building blocks concept
2121
Building blocks meta model
2222
++++++++++++++++++++++++++
2323

24-
The following figure gives an overview about the building blocks of the **S-CORE** **Platform**
25-
(blue box, top, 2nd column). The objectives of the platform of the **S-CORE** platform include
24+
The following figure gives an overview about the building blocks of the project **Platform**
25+
(blue box, top, 2nd column). The objectives of the project platform include
2626
enabling of feature integration for different use cases and domains. This includes safety-critical
2727
applications. Thus the intention is, that the platform can be developed as a Safety
2828
Element out of Context (**SEooC**) (green box, top, 1 column). The objectives of the platform are
2929
expressed as concrete **Stakeholder Requirements** (blue box, top, 2nd column), which can be tested
3030
by provided **Platform Tests** (blue box, top, 5nd column) for reference hardware platforms. The
3131
platform consists of **Features** (yellow box, middle, 2nd column).
3232

33-
Further **S-CORE** provides **Software Modules** (red box, middle, 1st column), which can also be
33+
Further the project provides **Software Modules** (red box, middle, 1st column), which can also be
3434
developed as a SEooC. A Software Module is defined as a **Component** (green box, middle, 2nd column)
3535
or a set of components realizing a Feature of the platform. In this sense a Software Module is the
3636
highest level component in our model. A Software Module represents e.g. executable code or a library.
@@ -63,15 +63,15 @@ to a Component.
6363
.. figure:: _assets/score_building_blocks_meta_model.drawio.svg
6464
:width: 100%
6565
:align: center
66-
:alt: Building blocks overview for **S-CORE** platform
66+
:alt: Building blocks overview for project platform
6767

68-
Building blocks overview for **S-CORE** platform
68+
Building blocks overview for the project platform
6969

7070
Building blocks example
7171
+++++++++++++++++++++++
7272

7373
The following figure is an example to explain the elements from the meta model. The user of the
74-
**S-CORE** platform wants to use the feature key-value-store. For that the user must integrate
74+
project platform wants to use the feature key-value-store. For that the user must integrate
7575
the software module "kvstorage". As this modules dependence on another module, the user must also
7676
integrate the software module "json_al". The module "kvstorage" is built-up by the
7777
components "kvs" and "fs", where the module "json_al" contains only one component "json_al".

process/general_concepts/score_lifecycle_concept.rst

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,27 +14,25 @@
1414
1515
.. _general_concepts_lifecycle:
1616

17-
Lifecylce concept
17+
Lifecycle concept
1818
-----------------
1919

20-
Contributions to the **S-CORE** project are driven by Change Requests.
20+
Contributions to the project are driven by Change Requests.
2121

2222
As features are the main structuring element of the platform, new features are requested by
2323
a change request from type feature. The request may be supported by source code.
2424
A new feature request happens in the **Concept Phase**.
2525

2626
During the **Development Phase** features are implemented and verified. The Development
2727
is planned, checked and adjusted to meet the requirements. Planning is also required from
28-
several standards especically to achieve functional safety.
28+
several standards especially to achieve functional safety.
2929

3030
Features are improved during the **Maintenance Phase**. In case bugs are found, they are also
3131
fixed during this phase.
3232

3333
.. figure:: _assets/score_lifecycle_model.drawio.svg
3434
:width: 100%
3535
:align: center
36-
:alt: Lifecycle model for S-CORE
37-
38-
Lifecycle model for S-CORE
39-
36+
:alt: Lifecycle model for the project
4037

38+
Lifecycle model for the project

process/general_concepts/score_review_concept.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ based on an implemented technical reviewer mechanism defined for the modified fi
8080
between reviewer(s) and author, the safety manager, security manager or quality manager can be added to the review to moderate a solution.
8181

8282
The initial step for requirements and architecture is the (informal) GitHub review on every Pull-Request
83-
(resp. Change Request, see `REPLACE_doc__contr_guideline`)
83+
(resp. Change Request, see :need:`gd_guidl__change__change_request`)
8484
which creates or modifies one of these work products (subject to inspection).
8585
After this review the work products are in status "valid", which means they can be used for further development and verification steps.
8686
In this review the checklist entries shall be considered which are tagged as "incremental".

0 commit comments

Comments
 (0)