template: added docs workflows (#17)

Addresses: #16
added reusable workflows for building and publishing documentation
uplifted docs-as-code to version 0.2.4

---------

Signed-off-by: Dan Calavrezo <[email protected]>

Author: dcalavrezo-qorix

.github/actions/deploy-versioned-pages/action.yml

@@ -0,0 +1,24 @@
+# *******************************************************************************
+# 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
+# *******************************************************************************
+
+name: Documentation Cleanup
+
+on:
+  schedule:
+    - cron: '0 0 * * *' # Runs every day at midnight UTC
+
+jobs:
+  docs-cleanup:
+    uses: eclipse-score/cicd-workflows/.github/workflows/docs-cleanup.yml@main
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/docs-cleanup.yml

@@ -0,0 +1,29 @@
+# *******************************************************************************
+# 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
+# *******************************************************************************
+
+name: Documentation
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize] # Allows forks to trigger the docs build
+  push:
+    branches:
+      - main
+  merge_group:
+    types: [checks_requested]
+
+jobs:
+  build-docs:
+    uses: eclipse-score/cicd-workflows/.github/workflows/docs.yml@main
+    with:
+      retention-days: 3

.github/workflows/docs.yml

@@ -62,4 +62,4 @@ bazel_dep(name = "aspect_rules_lint", version = "1.0.3")
 bazel_dep(name = "buildifier_prebuilt", version = "7.3.1")
 
 #docs-as-code
-bazel_dep(name = "score_docs_as_code", version = "0.2.1")
+bazel_dep(name = "score_docs_as_code", version = "0.2.4")

MODULE.bazel

@@ -31,7 +31,7 @@ Requirements
 ------------
 
 .. stkh_req:: Example Functional Requirement
-   :id: stkh_req__docgen_enabled
+   :id: stkh_req__docgen_enabled__example
    :status: valid
    :safety: QM
    :reqtype: Functional