docs: cleanup bundles

BUILD

@@ -27,24 +27,16 @@ docs(
     ],
     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",
+            "bundle": "//src/extensions/docs:extensions",
+            "mount_at": "internals/extensions",
         },
         {
             "bundle": "//src/extensions/score_metamodel/docs:metamodel",
             "mount_at": "reference/metamodel",
             "attach_to": "reference/index",
         },
     ],
-    scan_code = [
+    code_targets = [
         "//scripts_bazel:sources",
         "//src:all_sources",
     ],

docs/concepts/index.rst

@@ -24,3 +24,4 @@ Here you find explanations how and why docs-as-code works the way it does.
    bidirectional_traceability
    cross_module_compatibility
    docs_deps
+   mounts/index

docs/how-to/index.rst

@@ -27,6 +27,7 @@ Here you find practical guides on how to use docs-as-code.
    write_docs
    other_modules
    cross_module_compatibility
+   mounts/index
    dashboards_and_quality_gates
    source_to_doc_links
    test_to_doc_links

docs/internals/index.rst

@@ -21,7 +21,6 @@ This section is not relevant for users of docs-as-code but for developers extend
 .. toctree::
    :maxdepth: 1
 
-   extensions/index
    benchmark_results
    decisions/index
    requirements/index

src/extensions/score_mounts/docs/BUILD → src/extensions/docs/BUILD

@@ -13,24 +13,8 @@
 
 load("//:docs.bzl", "docs_bundle")
 
-# The mount feature's own documentation, mounted back into the site via the
-# mount feature itself (dogfooding). One subdirectory per bundle: mounts are
-# directory-scoped, so co-locating both files in one dir would graft both at
-# each mount point.
 docs_bundle(
-    name = "concept",
-    source_dir = "concept",
-    visibility = ["//visibility:public"],
-)
-
-docs_bundle(
-    name = "howto",
-    source_dir = "howto",
-    visibility = ["//visibility:public"],
-)
-
-docs_bundle(
-    name = "internals",
-    source_dir = "internals",
+    name = "extensions",
+    source_dir = "",
     visibility = ["//visibility:public"],
 )

docs/internals/extensions/index.rst → src/extensions/docs/index.rst

@@ -63,6 +63,12 @@ Extensions
       `ubCode <https://ubcode.useblocks.com>`__ VS Code extension.
       Getting IDE support for Sphinx-Needs in a Bazel context made easy.
 
+   .. grid-item-card::
+
+      Mounts
+      ^^^
+      Architecture and design of the ``score_mounts`` bridge extension.
+      :ref:`Mounts Extension Internals<score_mounts_internals>`
 
 
 .. toctree::
@@ -74,3 +80,4 @@ Extensions
    Source Code Linker <source_code_linker>
    Extension Guide <extension_guide>
    Sync TOML <sync_toml>
+   mounts_internals