feat(docs): provide a bundle per feature

BUILD

@@ -62,6 +62,60 @@ setup_starpls(
 )
 
 docs(
+    bundles = [
+        {
+            "bundle": "//docs/features/ai_platform:docs",
+            "mount_at": "features/ai_platform",
+        },
+        {
+            "bundle": "//docs/features/baselibs:docs",
+            "mount_at": "features/baselibs",
+        },
+        {
+            "bundle": "//docs/features/code_generation:docs",
+            "mount_at": "features/code_generation",
+        },
+        {
+            "bundle": "//docs/features/communication:docs",
+            "mount_at": "features/communication",
+        },
+        {
+            "bundle": "//docs/features/configuration:docs",
+            "mount_at": "features/configuration",
+        },
+        {
+            "bundle": "//docs/features/diagnostics:docs",
+            "mount_at": "features/diagnostics",
+        },
+        {
+            "bundle": "//docs/features/frameworks:docs",
+            "mount_at": "features/frameworks",
+        },
+        {
+            "bundle": "//docs/features/lifecycle:docs",
+            "mount_at": "features/lifecycle",
+        },
+        {
+            "bundle": "//docs/features/log_and_trace:docs",
+            "mount_at": "features/log_and_trace",
+        },
+        {
+            "bundle": "//docs/features/orchestration:docs",
+            "mount_at": "features/orchestration",
+        },
+        {
+            "bundle": "//docs/features/persistency:docs",
+            "mount_at": "features/persistency",
+        },
+        {
+            "bundle": "//docs/features/security_crypto:docs",
+            "mount_at": "features/security_crypto",
+        },
+        {
+            "bundle": "//docs/features/time:docs",
+            "mount_at": "features/time",
+        },
+    ],
     data = [
         "@score_process_description//:needs_json",
     ],

docs/conf.py

@@ -25,6 +25,13 @@
     "score_sphinx_bundle",
 ]
 
+# Feature documentation is provided by one Bazel bundle per feature and mounted
+# below ``features/``. Keep the live workspace sources out of the host
+# project's discovery so they are not registered twice by Sphinx.
+exclude_patterns = [
+    "features/*/**",
+]
+
 # Serve files from docs/_assets and load our own CSS overrides last so they win
 # over the styles shipped by the score_docs_as_code bundle.
 html_static_path = ["_assets"]

docs/features/ai_platform/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/baselibs/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/code_generation/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/communication/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/configuration/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/diagnostics/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/frameworks/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/index.rst

@@ -28,11 +28,10 @@ For further explanation see the `Building blocks concept <https://eclipse-score.
 
 The following features are defined:
 
+.. note: toctree will be filled by bazel build system, do not edit manually
+
 .. toctree::
    :maxdepth: 1
-   :glob:
-
-   */index
 
 Feature List
 ------------

docs/features/lifecycle/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/log_and_trace/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/orchestration/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/persistency/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/security_crypto/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)

docs/features/time/BUILD

@@ -0,0 +1,7 @@
+load("@score_docs_as_code//:docs.bzl", "docs_bundle")
+
+docs_bundle(
+    name = "docs",
+    source_dir = ".",
+    visibility = ["//visibility:public"],
+)