feat: docs_bundle

.github/workflows/test.yml

@@ -26,6 +26,12 @@ jobs:
         with:
           egress-policy: audit
 
+      - name: Install Graphviz
+        uses: eclipse-score/apt-install@main
+        with:
+          packages: graphviz
+          cache: false
+
       - name: Checkout repository (Handle all events)
         uses: actions/checkout@v4.2.2
         with:
@@ -49,6 +55,14 @@ jobs:
       - name: Run bazel test targets
         run: bazel test --lockfile_mode=error //... --build_tests_only
 
+      - name: Verify mount conflicts are rejected
+        run: |
+          ! bazel build --lockfile_mode=error //src/tests/mounts_conflict:bad
+          ! bazel build --lockfile_mode=error //src/tests/mounts_conflict:bad_attach_to
+
+      - name: Build an external documentation bundle from runfiles
+        run: bazel run --lockfile_mode=error //src/tests/mounts_external:docs
+
       - name: Build all targets
         # Skip tests, since some are non buildable negative tests
         run: bazel build --lockfile_mode=error //... -- -//src/tests/...

BUILD

@@ -20,6 +20,20 @@ docs(
     data = [
         "@score_process//:needs_json",
     ],
+    bundles = [
+        {
+            "bundle": "//src/extensions/score_mounts/docs:concept",
+            "mount_at": "concepts/mounts",
+        },
+        {
+            "bundle": "//src/extensions/score_mounts/docs:howto",
+            "mount_at": "how-to/mounts",
+        },
+        {
+            "bundle": "//src/extensions/score_mounts/docs:internals",
+            "mount_at": "internals/extensions/mounts",
+        },
+    ],
     scan_code = [
         "//scripts_bazel:sources",
         "//src:all_sources",

bzl/basics.bzl

@@ -0,0 +1,45 @@
+# *******************************************************************************
+# Copyright (c) 2026 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
+# *******************************************************************************
+def join_path(prefix, rest):
+    """Compose two docname segments with `/`.
+
+    Args:
+      prefix: Leading docname segment, possibly empty.
+      rest: Trailing docname segment, possibly empty.
+
+    Returns:
+      The combined docname.
+    """
+    if not prefix or prefix == ".":
+        return rest
+    if not rest:
+        return prefix
+    return prefix + "/" + rest
+
+def dirname(path):
+    idx = path.rfind("/")
+    return "" if idx < 0 else path[:idx]
+
+def glob_doc_sources(prefix):
+    """Return glob patterns for documentation sources below ``prefix``."""
+    extensions = [
+        "png", "svg", "md", "rst", "html", "css",
+        "puml", "need", "yaml", "json", "csv", "inc",
+    ]
+    if prefix == ".":
+        prefix = ""
+    elif prefix and not prefix.endswith("/"):
+        prefix += "/"
+    param = [prefix + "**/*." + ext for ext in extensions]
+    srcs = native.glob(param, allow_empty = True)
+    return srcs