add documentation examples

BUILD

@@ -23,7 +23,7 @@ setup_starpls(
 copyright_checker(
     name = "copyright",
     srcs = [
-        "src",
+        "score",
         "tests",
         "//:BUILD",
         "//:MODULE.bazel",
@@ -44,5 +44,8 @@ dash_license_checker(
 use_format_targets()
 
 docs(
+    data = [
+        "@score_process//:needs_json",
+    ],
     source_dir = "docs",
 )

MODULE.bazel

@@ -15,7 +15,7 @@ module(
     version = "1.0",
 )
 
-bazel_dep(name = "rules_python", version = "1.4.1", dev_dependency = True)
+bazel_dep(name = "rules_python", version = "1.8.3", dev_dependency = True)
 
 # Python 3.12: Required for testing infrastructure and code generation tools
 PYTHON_VERSION = "3.12"
@@ -57,9 +57,16 @@ use_repo(llvm, "llvm_toolchain_llvm")
 register_toolchains("@llvm_toolchain//:all")
 
 # tooling
-bazel_dep(name = "score_tooling", version = "1.0.4", dev_dependency = True)
+bazel_dep(name = "score_tooling", version = "1.2.0", dev_dependency = True)
 bazel_dep(name = "aspect_rules_lint", version = "1.10.2", dev_dependency = True)
 bazel_dep(name = "buildifier_prebuilt", version = "8.2.0.2", dev_dependency = True)
 
 #docs-as-code
-bazel_dep(name = "score_docs_as_code", version = "2.3.0", dev_dependency = True)
+bazel_dep(name = "score_docs_as_code", version = "3.1.0", dev_dependency = True)
+bazel_dep(name = "score_process", version = "1.5.1", dev_dependency = True)
+
+git_override(
+    module_name = "score_docs_as_code",
+    commit = "927fcd9a3eb624248af6bb990ea85edfe63cb38c",
+    remote = "https://github.com/eclipse-score/docs-as-code.git",
+)

README.md

@@ -31,7 +31,7 @@ It provides a **standardized project structure**, ensuring best practices for:
 | File/Folder                         | Description                                       |
 | ----------------------------------- | ------------------------------------------------- |
 | `README.md`                         | Short description & build instructions            |
-| `src/`                              | Source files and Unit Tests for the module        |
+| `score/`                            | Source files and Unit Tests for the module        |
 | `tests/`                            | Component and Feature Integration Tests (CIT&FIT) |
 | `examples/`                         | Example files used for guidance                   |
 | `docs/`                             | Documentation (Doxygen for C++ / mdBook for Rust) |
@@ -61,15 +61,15 @@ cd YOUR_PROJECT
 To build all targets of the module the following command can be used:
 
 ```sh
-bazel build //src/...
+bazel build //score/...
 ```
 
 This command will instruct Bazel to build all targets that are under Bazel
-package `src/`. The ideal solution is to provide single target that builds
+package `score/`. The ideal solution is to provide single target that builds
 artifacts, for example:
 
 ```sh
-bazel build //src/<module_name>:release_artifacts
+bazel build //score/<module_name>:release_artifacts
 ```
 
 where `:release_artifacts` is filegroup target that collects all release
@@ -89,7 +89,7 @@ bazel test //...
 Unit tests:
 
 ```sh
-bazel test //src/...
+bazel test //score/...
 ```
 
 Component / Feature integration tests:
@@ -114,6 +114,10 @@ The template integrates **tools and linters** from **centralized repositories**
 
 - A **centralized docs structure** is planned.
 
+```sh
+bazel run //:docs
+```
+
 ---
 
 ## ⚙️ `project_config.bzl`

docs/aou_requirements_template.rst

@@ -0,0 +1,71 @@
+..
+   # *******************************************************************************
+   # 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
+   # *******************************************************************************
+
+AoU Requirements Template
+=========================
+
+This page contains Assumption of Use requirement snippets that belong to the
+template repository.
+
+Platform AoU
+------------
+
+.. code-block:: rst
+
+   .. aou_req:: Some Other Title
+      :id: aou_req__platform__some_other_title
+      :reqtype: Interface
+      :security: YES
+      :safety: ASIL_B
+      :status: invalid
+
+      The Platform User shall do xyz to use the platform safely.
+
+Feature AoU
+-----------
+
+.. code-block:: rst
+
+   .. aou_req:: Some Other Title
+      :id: aou_req__feature_name__some_other_title
+      :reqtype: Process
+      :security: NO
+      :safety: ASIL_B
+      :status: invalid
+
+      The Feature User shall do xyz to use the feature safely.
+
+Component AoU
+-------------
+
+.. code-block:: rst
+
+   .. aou_req:: Next Title
+      :id: aou_req__mod_temp_component_name__next_title
+      :reqtype: Process
+      :security: YES
+      :safety: ASIL_B
+      :status: invalid
+
+      The Component User shall do xyz to use the component safely/securely
+
+   .. aou_req:: Another Title
+      :id: aou_req__mod_temp_component_name__another
+      :reqtype: Process
+      :security: YES
+      :safety: ASIL_B
+      :status: invalid
+      :tags: environment
+
+      The Component shall only be used in a xyz environment to ensure its proper functioning.