Documentation Management Plan
|
status: valid
security: YES
safety: ASIL_B
|
||||
Documentation Management Plan#
Purpose#
The documentation management plan describes how documents are handled in the S-CORE project.
Objectives and scope#
Goal of this plan is to describe
which documents exist
which attributes and lifecycle they have
how they are reviewed
Approach#
Some of the work products of the S-CORE project are modelled specifically (e.g. the requirements and architecture have a specific set of attributes) Others are modelled as general documents (e.g. the plans which are part of the program management plan or the verification reports).
This plan deals with these documents, which have the following manually set attributes:
Title: The name of the document (mandatory)
Unique Id: Id following the naming pattern of the document Title (mandatory)
Safety: Which ASIL the document supports (mandatory)
Author: Who is the main committer to the document (mandatory, but set automatically by the github information)
Status: Describing where in the lifecycle of the document it currently is (mandatory)
Tags: Can be used to group documents for subsequent filtering (optional)
Also the “Documentation Management” is a document, so an example for a correct document definition can be seen in the header section above, see Documentation Management Plan (doc__documentation_mgt_plan).
The following additional attributes of the document are generated automatically during the documentation build:
Approver: from the github information on who was the last CODEOWNER performing the github review
Reviewer: any additional reviewer performing the github review without CODEOWNER rights
The lifecycle of S-CORE documents has two states:
Draft: The document is filled with content but not completed, the existing content is reviewed and already applicable
Valid: The document is completed and approved
If a document is invalidated it is removed from the project entirely. A document can also transition from valid to draft, for example if a release was done with a valid verification report and then the development for the next release is started.
Invalidated documents are still observable as part of the git history in the unlikely case of later referral (e.g. for design decisions or audit). In this way, there is even an option to recover the content.
The review of each document is done as defined for this type of work product in the respective process description. This means that for some of the work products dedicated checklists are defined, but for others there are not. In any case the reviews are done in a github review at least by one CODEOWNER who is not the author of the document.
Generally all work products (specific and general documents) are subject to a documentation build, which always contains the latest version of the documents for each pull-request. Versioning of documents is done as for every work product with github means and is defined in the configuration management plan.
The time schedule is not part of the documentation management plan. As described in the project management plan GitHub issues is used to plan and track the work.
The following tables list all documents. The documentation is structured in several folders Platform Folder Structure, each representing a specific aspect of the project. First the documents of the platform folders are listed. Afterwards the documents are listed per feature: for each feature the feature documents are followed by the documents of the implementing modules and their components. Finally all further documents, which do not belong to one of these sections, are listed.
Note
The tables of this plan are generated during the documentation build from the documents which are part of that build. Therefore this plan looks different depending on where it is built:
S-CORE platform repository: only the documents of the platform repository are listed. The module repositories are not part of this build, so the module and component tables are empty. Only the module documentation still located in the folder
docs/modulesof the platform repository is listed there. This documentation is not yet transferred into the module repositories, see Module Folder Structure. Also the section “Further documents” is empty.Reference integration: the module repositories and further dependencies (e.g. the process description and docs-as-code) are part of the build. Therefore the tables additionally contain the module and component documents of these repositories and the section “Further documents” lists the documents of the other dependencies.
The structure of the plan is the same in both cases.
Platform documentation#
docs#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Handbook |
ASIL_B |
YES |
valid |
docs/architecture#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Platform Architecture |
ASIL_B |
YES |
valid |
docs/contribute#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Feature Request Guideline |
QM |
NO |
valid |
|
Contribution Guideline |
QM |
NO |
valid |
|
Pull Request Guideline |
QM |
NO |
valid |
|
Issue Guideline |
QM |
NO |
valid |
|
API Guidelines |
QM |
NO |
draft |
|
Static Code Analysis C++ |
ASIL_B |
YES |
valid |
|
Coding Guidelines C++ |
ASIL_B |
YES |
valid |
|
MISRA C++:2023 Rule Mapping |
ASIL_B |
YES |
draft |
|
Development Environment |
ASIL_B |
YES |
valid |
|
Coding Guidelines Python |
QM |
NO |
valid |
|
Coding Guidelines Rust |
ASIL_B |
YES |
valid |
|
Rust API design guidelines |
QM |
NO |
draft |
|
Traceability Tooling |
QM |
NO |
valid |
|
Git Guidelines |
ASIL_B |
NO |
valid |
|
Naming Conventions |
ASIL_B |
YES |
valid |
|
Contribution |
ASIL_B |
YES |
valid |
docs/platform_management_plan#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Change Management Plan |
ASIL_B |
YES |
valid |
|
Configuration Management Plan |
ASIL_B |
YES |
draft |
|
Documentation Management Plan |
ASIL_B |
YES |
valid |
|
Platform Management Glossary |
ASIL_B |
YES |
draft |
|
Platform Management Plan |
ASIL_B |
YES |
draft |
|
Problem Resolution Plan |
ASIL_B |
YES |
draft |
|
Project Management Plan |
ASIL_B |
YES |
valid |
|
Platform Quality Management Plan |
ASIL_B |
YES |
valid |
|
Release Management Plan |
ASIL_B |
NO |
draft |
|
Platform Quality Manager |
ASIL_B |
YES |
valid |
|
Platform Safety Engineer |
ASIL_B |
YES |
valid |
|
Platform Safety Manager |
ASIL_B |
YES |
valid |
|
Platform Security Manager |
ASIL_B |
YES |
valid |
|
Platform Safety Plan |
ASIL_B |
NO |
draft |
|
Platform Security Plan |
ASIL_B |
YES |
draft |
|
Software Development Plan |
ASIL_B |
YES |
valid |
|
Software Verification Plan |
ASIL_B |
YES |
valid |
|
Tool Management Plan |
ASIL_B |
YES |
valid |
|
Platform Vulnerability Management Plan |
ASIL_B |
YES |
draft |
docs/quality#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Quality Report |
ASIL_B |
YES |
draft |
docs/requirements#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
SW-platform Assumptions |
ASIL_B |
YES |
draft |
|
SW-platform stakeholder requirements |
ASIL_B |
YES |
draft |
docs/safety#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Safety Analysis Formal Review Report |
ASIL_B |
NO |
draft |
|
Platform Safety Package Formal Review |
ASIL_B |
NO |
draft |
|
S-CORE Platform Safety Plan Formal Review |
ASIL_B |
NO |
draft |
|
Platform DFA |
ASIL_B |
NO |
draft |
|
Platform Safety Manual |
ASIL_B |
NO |
draft |
docs/score_tools#
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Tool Evaluation List |
ASIL_B |
YES |
draft |
|
Tools Requirements |
ASIL_B |
YES |
valid |
Title |
ID |
Safety Affected |
Security Affected |
Status |
|---|---|---|---|---|
Bazel |
YES |
YES |
draft |
|
gcc |
NO |
NO |
draft |
|
qcc |
YES |
YES |
draft |
|
Doc-as-Code |
YES |
YES |
evaluated |
|
clang-format |
YES |
YES |
evaluated |
|
clang-tidy |
YES |
YES |
evaluated |
|
clippy |
YES |
YES |
evaluated |
|
rustfmt |
YES |
YES |
evaluated |
|
gtest |
YES |
YES |
draft |
|
ITF |
YES |
YES |
draft |
|
pytest |
YES |
YES |
evaluated |
|
github |
YES |
YES |
draft |
Feature, module and component documentation#
In the following sections the documents of the features, that are planned for release v1.0, are listed.
The features of the platform repository (docs/features) are used as structure. For each feature the
documents are listed in the following order:
Feature documents: the feature documents of the platform repository (see Platform Folder Structure) and the feature documents of the implementing module(s) (
docs/features, see Module Folder Structure)Module documents: the documents on module level of the implementing module(s), e.g. module safety plan, safety manual, release note and verification report (
docs/module,docs/verification_report)Component documents: the documents of the components of the implementing module(s), e.g. requirements, architecture, detailed design, safety analyses and their inspection checklists (
score/<component_name>/docs)
The modules implementing a feature are listed with their Bazel module name, which is also used as folder name for the module documentation in the reference integration. If no module is assigned to a feature or a table is empty, the corresponding documentation is missing in the build.
AI platform#
Modules: none
Note
The incubation repositories inc_ai_platform and inc_gen_ai were archived on 2026-03-10.
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
AI-Platform Architecture |
ASIL_B |
NO |
draft |
|
Gen-AI Architecture |
QM |
NO |
draft |
|
Gen-AI |
QM |
NO |
draft |
|
AI-Platform |
ASIL_B |
NO |
draft |
Module documents
No module is assigned to this feature yet.
Component documents
No module is assigned to this feature yet.
Baselibs#
Modules: score_baselibs
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Baselibs Architecture |
ASIL_B |
YES |
valid |
|
Base Libraries |
ASIL_B |
YES |
valid |
|
Baselibs Requirements Inspection Checklist |
ASIL_B |
YES |
valid |
|
Baselibs Requirements |
ASIL_B |
YES |
valid |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Code generation#
Modules: none
Note
The incubation repository inc_score_codegen was archived on 2026-03-10.
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Code-Generation Architecture |
ASIL_B |
NO |
draft |
|
Code-Generation |
ASIL_B |
NO |
draft |
Module documents
No module is assigned to this feature yet.
Component documents
No module is assigned to this feature yet.
Communication#
Modules: score_communication, score_someip_gateway, communication
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Communication |
ASIL_B |
YES |
valid |
|
IPC Architecture |
ASIL_B |
YES |
valid |
|
Inter-process Communication |
ASIL_B |
YES |
valid |
|
IPC Requirements |
ASIL_B |
YES |
valid |
|
IPC DFA |
ASIL_B |
NO |
draft |
|
IPC FMEA |
ASIL_B |
NO |
draft |
|
Communication IPC Safety WPs |
ASIL_B |
YES |
draft |
|
Communication Requirements |
ASIL_B |
YES |
valid |
|
SOME_IP-Gateway |
ASIL_B |
YES |
valid |
Module documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Communication Safety Manual |
ASIL_B |
NO |
draft |
|
Communication Release Note |
ASIL_B |
YES |
valid |
|
Communication Assumptions of Use |
ASIL_B |
NO |
valid |
|
Communication Codeowners |
ASIL_B |
YES |
valid |
|
Communication Safety Package Formal Review |
ASIL_B |
NO |
draft |
|
Communication Safety Plan |
ASIL_B |
NO |
draft |
|
Communication Safety Plan Formal Review |
ASIL_B |
NO |
draft |
|
Communication Verification Report |
ASIL_B |
YES |
draft |
Component documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
LoLa Architecture |
ASIL_B |
YES |
draft |
|
lola Component Classification |
ASIL_B |
NO |
draft |
|
LoLa Detailed Design |
ASIL_B |
YES |
draft |
|
LoLa |
ASIL_B |
YES |
draft |
|
LoLa Requirements |
ASIL_B |
YES |
draft |
|
lola DFA |
ASIL_B |
NO |
draft |
|
lola FMEA |
ASIL_B |
NO |
draft |
Configuration#
Modules: score_config_management
Note
The incubation repository inc_config_management was archived on 2026-03-10, the module is continued in the repository config_management (score_config_management).
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Configuration Management Architecture |
ASIL_B |
YES |
draft |
|
Configuration Management |
ASIL_B |
YES |
draft |
|
Configuration Model |
QM |
NO |
draft |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Diagnostics#
Modules: score_diagnostics
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Diagnostics Architecture |
QM |
YES |
draft |
|
Diagnostics |
QM |
YES |
draft |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Frameworks (DAAL, FEO)#
Modules: score_feo, score_inc_daal, feo
Note
The incubation repository inc_feo was archived on 2026-03-10, the module is continued in the repository feo (score_feo).
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Deterministic App Abstraction Layer Architecture |
QM |
NO |
draft |
|
Deterministic App Abstraction Layer |
QM |
NO |
valid |
|
FEO Feature Architecture Inspection Checklist |
ASIL_B |
NO |
draft |
|
FEO Feature Architecture |
ASIL_B |
NO |
valid |
|
Fixed execution order framework |
ASIL_B |
NO |
valid |
|
FEO Assumptions of Use Requirements |
ASIL_B |
NO |
draft |
|
FEO Feature Requirements Inspection Checklist |
ASIL_B |
NO |
draft |
|
FEO Feature Requirements |
ASIL_B |
NO |
valid |
|
FEO Feature Safety Analysis Inspection Checklist |
ASIL_B |
NO |
draft |
|
FEO Feature DFA |
ASIL_B |
NO |
draft |
|
FEO Feature FMEA |
ASIL_B |
NO |
draft |
|
FEO Safety Work Products |
ASIL_B |
NO |
valid |
Module documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
FEO Module Safety Manual |
ASIL_B |
NO |
draft |
|
FEO Module Release Note |
ASIL_B |
NO |
valid |
|
FEO Module Safety Package Formal Review |
ASIL_B |
NO |
draft |
|
FEO Module Safety Plan |
ASIL_B |
NO |
valid |
|
FEO Module Safety Plan Formal Review |
ASIL_B |
NO |
draft |
|
FEO Module Verification Report |
ASIL_B |
NO |
draft |
Component documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
FEO Component Architecture Inspection Checklist |
ASIL_B |
NO |
draft |
|
FEO Component Architecture |
ASIL_B |
NO |
draft |
|
FEO Component Classification |
ASIL_B |
NO |
draft |
|
FEO Implementation Inspection Checklist |
ASIL_B |
NO |
draft |
|
FEO Component Detailed Design |
ASIL_B |
NO |
draft |
|
FEO Component |
ASIL_B |
YES |
draft |
|
FEO Component Assumptions of Use Requirements |
ASIL_B |
NO |
draft |
|
FEO Component Requirements Inspection Checklist |
ASIL_B |
YES |
draft |
|
FEO Component Requirements |
ASIL_B |
NO |
draft |
|
FEO Safety Analysis Inspection Checklist |
ASIL_B |
NO |
draft |
|
FEO Component DFA |
ASIL_B |
NO |
draft |
|
FEO FMEA |
ASIL_B |
NO |
draft |
Lifecycle#
Modules: score_lifecycle
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Lifecycle Architecture |
ASIL_B |
YES |
valid |
|
Lifecycle |
ASIL_B |
YES |
valid |
|
Lifecycle Requirements |
ASIL_B |
YES |
valid |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Log and trace#
Modules: score_logging
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Logging Architecture |
ASIL_B |
YES |
valid |
|
doc__logging |
ASIL_B |
YES |
draft |
|
Logging Requirements Inspection Checklist |
ASIL_B |
YES |
draft |
|
Logging Requirements |
ASIL_B |
YES |
valid |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Orchestration#
Modules: score_kyron, orchestrator
Note
The repository orchestrator was archived on 2026-09-21. The module documentation still available in the platform repository (docs/modules/orchestrator) is kept.
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Orchestration Architecture |
ASIL_B |
YES |
draft |
|
Orchestration |
ASIL_B |
YES |
valid |
|
Orchestration Requirements |
ASIL_B |
YES |
valid |
|
Orchestration DFA |
ASIL_B |
YES |
draft |
|
Orchestration FMEA |
ASIL_B |
YES |
draft |
|
Orchestration Safety WPs |
ASIL_B |
YES |
draft |
Module documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Orchestrator Safety Manual |
ASIL_B |
YES |
draft |
|
Orchestrator Release Note |
ASIL_B |
YES |
draft |
|
Orchestrator Codeowners |
ASIL_B |
YES |
valid |
|
Orchestrator Safety Package Formal Review |
ASIL_B |
YES |
draft |
|
Orchestrator Safety Plan |
ASIL_B |
YES |
draft |
|
Orchestrator Safety Plan Formal Review |
ASIL_B |
YES |
draft |
|
Orchestrator Verification Report |
ASIL_B |
YES |
draft |
|
Orchestrator |
ASIL_B |
YES |
draft |
Component documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Executor Architecture Inspection Checklist |
ASIL_B |
YES |
draft |
|
Executor Architecture |
ASIL_B |
YES |
valid |
|
Executor Detailed Design |
ASIL_B |
YES |
draft |
|
Executor |
ASIL_B |
YES |
draft |
|
Executor Requirements Inspection Checklist |
ASIL_B |
YES |
draft |
|
Executor Requirements |
ASIL_B |
YES |
draft |
|
Executor DFA |
ASIL_B |
YES |
draft |
|
Executor FMEA |
ASIL_B |
YES |
draft |
|
Orchestrator Architecture Inspection Checklist |
ASIL_B |
YES |
draft |
|
Orchestrator Architecture |
ASIL_B |
YES |
valid |
|
Orchestrator Detailed Design |
ASIL_B |
YES |
draft |
|
Orchestrator |
ASIL_B |
YES |
draft |
|
Orchestrator Requirements Inspection Checklist |
ASIL_B |
YES |
draft |
|
Orchestrator Requirements |
ASIL_B |
YES |
draft |
|
Orchestrator DFA |
ASIL_B |
YES |
draft |
|
Orchestrator FMEA |
ASIL_B |
YES |
draft |
Operating system#
Modules: os
Note
The repository operating_system was archived on 2026-03-10. The module documentation still available in the platform repository (docs/modules/os) is kept.
Feature documents
There is no dedicated feature for the operating system.
Module documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Operating System Assumptions of Use |
ASIL_B |
YES |
draft |
|
QNX Assumptions of Use |
ASIL_B |
YES |
draft |
|
Operating System Requirements |
ASIL_B |
YES |
draft |
Component documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
[OS Name] |
QM |
YES |
draft |
Persistency#
Modules: score_persistency
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Persistency KVS Feature Architecture |
ASIL_B |
NO |
valid |
|
Persistency |
ASIL_B |
NO |
valid |
|
Persistency Requirements Inspection Checklist |
ASIL_B |
NO |
valid |
|
Persistency Requirements |
ASIL_B |
YES |
valid |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Security and crypto#
Modules: score_security_crypto
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Security & Crypto Architecture |
QM |
YES |
draft |
|
Security & Crpyto Feature Requirements |
QM |
YES |
valid |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Time#
Modules: score_time
Feature documents
Title |
ID |
Safety |
Security |
Status |
|---|---|---|---|---|
Time Architecture |
ASIL_B |
YES |
draft |
|
Time |
ASIL_B |
YES |
valid |
|
Time Assumption of Use Requirements |
ASIL_B |
NO |
draft |
Module documents
No needs passed the filters
Component documents
No needs passed the filters
Further documents#
This section lists all documents which are part of the documentation build but are not assigned to one of the sections above, e.g. documents of included dependencies or of modules which are not yet assigned to a feature.
No needs passed the filters
No needs passed the filters