update release management

Add new wor product handbook and workflow
remove build configurations as separate wps, but add it to the release notes

Resolves: #212

Author: masc2023

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

@@ -129,7 +129,7 @@ Module Work products List
           - <Link to WP>
           - <WP status (manual)>
 
-        * - :need:`wp__module_sw_build_config`
+        * - :need:`wp__module_sw_release_note`
           - :need:`gd_temp__software_development_plan`
           - `copy('status', need_id='gd_temp__software_development_plan')`
           - <Link to issue>

process/process_areas/release_management/release_getstrt.rst

@@ -27,7 +27,7 @@ Releases can be done in every repository, mainly:
 * Platform (Main project/Integration) repository
 * Module (platform's components) repositories
 
-For this are available: templates :need:`gd_temp__rel_plat_rel_note` & :need:`gd_temp__rel_mod_rel_note`
+For these are available: templates :need:`gd_temp__rel_plat_rel_note` & :need:`gd_temp__rel_mod_rel_note`
 or `Combined Release Template <https://github.com/eclipse-score/process_description/blob/main/.github/RELEASE_TEMPLATE.md>`_,
 guidelines :need:`gd_guidl__rel_management` and a :need:`doc_concept__rel_process`
 are available.
@@ -42,5 +42,6 @@ The following workflows are executed:
 * Create a release plan for the platform according to :need:`wf__rel_plat_rel_plan`
 * Create a release plan for the module according to :need:`wf__rel_mod_rel_plan`
 * According to the planning create release notes for modules :need:`wf__rel_mod_rel_note` and platform :need:`wf__rel_platform_rel_note`
+* According to the planning create the platform handbook :need:`wf__rel_platform_handbook`
 
 In addition create a release management plan as part of the platform management plan according to :need:`wf__platform_cr_mt_platform_mgmt_plan`.

process/process_areas/release_management/release_workflow.rst

@@ -69,6 +69,20 @@ For a detailed explanation of workflows and their role within the process model,
 
    The platform release plan is created as part of the project planning and documented in the platform management plan.
 
+
+.. workflow:: Create/Maintain Platform Handbook
+   :id: wf__rel_platform_handbook
+   :status: valid
+   :responsible: rl__project_lead
+   :approved_by: rl__project_lead
+   :input: wp__platform_safety_package, wp__platform_sw_release_plan, wp__verification_platform_ver_report
+   :output: wp__platform_handbook
+   :contains:
+   :has: doc_concept__rel_process, doc_getstrt__release_process
+
+   The platform handbook is prepared and approved by the project lead circle.
+   It may be updated later in case of bugs found after the release is published.
+
 RAS(IC) for Release Management:
 *******************************
 

process/process_areas/release_management/release_workproducts.rst

@@ -26,6 +26,11 @@ Release Management Work Products
    platform versions and provide information regarding the time of the release.
    It includes known bugs from own testing and field reporting, with clear statement,
    that these bugs do not lead to violation of any safety requirements or which workaround measures need to be applied.
+   It contains also the build configuration capable to create the SEooC Library for the
+   reference HW, platform level.
+
+   Note: Embedded software in the sense of the Iso (i.e. deployed on the production HW)
+   is not part of our delivery.
 
 .. workproduct:: Module Release Notes
    :id: wp__module_sw_release_note
@@ -37,6 +42,11 @@ Release Management Work Products
    information regarding the time of the release. It includes known bugs from own testing and field reporting,
    with clear statement, that these bugs do not lead to violation of any safety requirements or
    which workaround measures need to be applied.
+   It contains also the build configuration capable to create the SEooC Library for the
+   reference HW, module level.
+
+   Note: Embedded software in the sense of the Iso (i.e. deployed on the production HW)
+   is not part of our delivery.
 
 .. workproduct:: Platform Release Plan
    :id: wp__platform_sw_release_plan
@@ -56,3 +66,20 @@ Release Management Work Products
    module releases along with their estimated release dates. It provides a roadmap for the
    development and release of new features, ensuring that all stakeholders are aligned on the
    module's future direction.
+
+.. workproduct:: Platform Handbook
+   :id: wp__platform_handbook
+   :status: valid
+
+   The platform handbook is a tutorial to explain how the project works from a technical
+   perspective. It explains the background of the project, but also what the project is
+   not about.
+
+   Further it contains:
+
+   - Overview of the technologies used within the project
+   - Software architecture overview
+   - Module structure overview
+   - Integration process
+   - Getting started guide
+   - Contribution guide

process/process_areas/security_management/guidance/security_management_module_security_plan_template.rst

@@ -102,7 +102,7 @@ Module Security Plan Template
           - <Link to WP>
           - <WP status (manual)>
 
-        * - :need:`wp__module_sw_build_config`
+        * - :need:`wp__module_sw_release_note`
           - :need:`Software Development Plan Template <gd_temp__software_development_plan>`
           - <automated>
           - <Link to issue>

process/workproducts/index.rst

@@ -22,11 +22,7 @@ An work product is an items needed as input or created as output of one or more
 The project development work product traceability model overview can be found here: :ref:`general_concepts_traceability`.
 
 
-Platform management
---------------------
-
-General
-^^^^^^^
+Here only project specific work products are listed, which are generic for the platform.
 
 .. workproduct:: Policies
    :id: wp__policies
@@ -55,33 +51,6 @@ General
    ones from ECLIPSE.
 
 
-Product development
--------------------
-
-Platform development
-^^^^^^^^^^^^^^^^^^^^
-
-.. workproduct:: Platform Build Configuration
-   :id: wp__platform_sw_build_config
-   :status: draft
-   :tags: safety
-   :complies: std_wp__iso26262__software_1052
-
-   Build configuration capable to create the SEooC Library for the reference HW, platform level.
-   Note: Embedded software in the sense of the Iso (i.e. deployed on the production HW) is not part of our delivery.
-
-
-Component development
-^^^^^^^^^^^^^^^^^^^^^
-
-.. workproduct:: Module Build Configuration
-   :id: wp__module_sw_build_config
-   :status: draft
-   :tags: safety
-   :complies: std_wp__iso26262__software_1052
-
-   Build configuration capable to create the SEooC Library for the reference HW, module level.
-   Note: Embedded software in the sense of the Iso (i.e. deployed on the production HW) is not part of our delivery.
 
 
 Project Work product Linkage