From c59113c7a59cba3ab5b55d08de6a3aa98c628d59 Mon Sep 17 00:00:00 2001 From: "jhr2hi@bosch.com" Date: Tue, 20 Jan 2026 11:55:03 +0100 Subject: [PATCH 1/4] fix issues which prevent latest main update --- MODULE.bazel | 2 +- docs/internals/requirements/requirements.rst | 17 ++++++++--------- src/extensions/score_metamodel/metamodel.yaml | 2 +- 3 files changed, 10 insertions(+), 11 deletions(-) diff --git a/MODULE.bazel b/MODULE.bazel index ffebf8d2..c7f9c56a 100644 --- a/MODULE.bazel +++ b/MODULE.bazel @@ -100,7 +100,7 @@ http_file( # docs dependency # Note: requirements were last aligned with 1.2.0, # the switch to 1.3.1 is purely to drop the dependency on docs-as-code 1.x. -bazel_dep(name = "score_process", version = "1.3.2") +bazel_dep(name = "score_process", version = "1.4.2") # Add Linter bazel_dep(name = "rules_multitool", version = "1.9.0") diff --git a/docs/internals/requirements/requirements.rst b/docs/internals/requirements/requirements.rst index 52203074..7e0a0940 100644 --- a/docs/internals/requirements/requirements.rst +++ b/docs/internals/requirements/requirements.rst @@ -689,9 +689,8 @@ Architecture Attributes :parent_covered: NO: we only enable linking, we do not link :satisfies: gd_req__req_attr_impl, - gd_req__impl_design_code_link, - Docs-as-Code shall allow source code to link to needs. + Docs-as-Code shall allow source code to link to requirement needs. A link to the corresponding source code location in GitHub shall be generated in the generated documentation within the linked requirement. @@ -720,14 +719,14 @@ Architecture Attributes Provide needs type ``dd_sta`` for static diagrams showing unit interactions as UML. -.. tool_req:: Dynamic Diagram for Unit Interactions - :id: tool_req__docs_dd_dyn - :tags: Detailed Design & Code - :implemented: YES - :parent_covered: YES - :satisfies: gd_req__impl_dynamic_diagram +.. .. tool_req:: Dynamic Diagram for Unit Interactions +.. :id: tool_req__docs_dd_dyn +.. :tags: Detailed Design & Code +.. :implemented: YES +.. :parent_covered: YES +.. :satisfies: gd_req__impl_dynamic_diagram - Provide needs type ``dd_dyn`` for dynamic diagrams showing unit interactions as UML. +.. Provide needs type ``dd_dyn`` for dynamic diagrams showing unit interactions as UML. Testing diff --git a/src/extensions/score_metamodel/metamodel.yaml b/src/extensions/score_metamodel/metamodel.yaml index f0086b87..1cf26e50 100644 --- a/src/extensions/score_metamodel/metamodel.yaml +++ b/src/extensions/score_metamodel/metamodel.yaml @@ -684,7 +684,7 @@ needs_types: includes: sw_unit, sw_unit_int parts: 3 - # req-Id: tool_req__docs_dd_dyn + # req-Id: dd_dyn: title: Dynamic detailed design color: #FEDCD2 From 31fb7a0ca7dfd8696f2757e1450929d7ebab0df4 Mon Sep 17 00:00:00 2001 From: RolandJentschETAS <135332348+RolandJentschETAS@users.noreply.github.com> Date: Tue, 20 Jan 2026 13:49:22 +0100 Subject: [PATCH 2/4] Clarify linked requirement documentation Update documentation to specify 'sphinx-needs' for linked requirements. Signed-off-by: RolandJentschETAS <135332348+RolandJentschETAS@users.noreply.github.com> --- docs/internals/requirements/requirements.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/internals/requirements/requirements.rst b/docs/internals/requirements/requirements.rst index 7e0a0940..d5b39412 100644 --- a/docs/internals/requirements/requirements.rst +++ b/docs/internals/requirements/requirements.rst @@ -693,7 +693,7 @@ Architecture Attributes Docs-as-Code shall allow source code to link to requirement needs. A link to the corresponding source code location in GitHub shall be generated in the - generated documentation within the linked requirement. + generated documentation within the linked sphinx-needs requirement. From 3454b8429ebd6ec8945c86c5801ac6b24a3f69bd Mon Sep 17 00:00:00 2001 From: RolandJentschETAS <135332348+RolandJentschETAS@users.noreply.github.com> Date: Tue, 20 Jan 2026 13:50:30 +0100 Subject: [PATCH 3/4] Remove commented-out req-Id from metamodel.yaml Removed commented-out req-Id section from metamodel.yaml. Signed-off-by: RolandJentschETAS <135332348+RolandJentschETAS@users.noreply.github.com> --- src/extensions/score_metamodel/metamodel.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/src/extensions/score_metamodel/metamodel.yaml b/src/extensions/score_metamodel/metamodel.yaml index 1cf26e50..42c7ced9 100644 --- a/src/extensions/score_metamodel/metamodel.yaml +++ b/src/extensions/score_metamodel/metamodel.yaml @@ -684,7 +684,6 @@ needs_types: includes: sw_unit, sw_unit_int parts: 3 - # req-Id: dd_dyn: title: Dynamic detailed design color: #FEDCD2 From fcedae9b6c030811a318f8d25fc559a6b751a2ca Mon Sep 17 00:00:00 2001 From: RolandJentschETAS <135332348+RolandJentschETAS@users.noreply.github.com> Date: Tue, 20 Jan 2026 13:53:23 +0100 Subject: [PATCH 4/4] Update documentation for linking requirements in Docs-as-Code Signed-off-by: RolandJentschETAS <135332348+RolandJentschETAS@users.noreply.github.com> --- docs/internals/requirements/requirements.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/internals/requirements/requirements.rst b/docs/internals/requirements/requirements.rst index d5b39412..816646cb 100644 --- a/docs/internals/requirements/requirements.rst +++ b/docs/internals/requirements/requirements.rst @@ -690,10 +690,10 @@ Architecture Attributes :satisfies: gd_req__req_attr_impl, - Docs-as-Code shall allow source code to link to requirement needs. + Docs-as-Code shall allow source code to link to requirement sphinx-needs objects. A link to the corresponding source code location in GitHub shall be generated in the - generated documentation within the linked sphinx-needs requirement. + generated documentation within the linked requirement.