[rules score] bugfix document not included in toctree (#519)

Author: hoe-jo

bazel/rules/rules_score/private/dependable_element.bzl

@@ -1229,6 +1229,12 @@ def _dependable_element_index_impl(ctx):
     # Sphinx sidebar navigation.
     component_entries = ["components/" + name for name in component_refs]
 
+    # Units listed directly in components have no parent component page, so
+    # link their pages from the Components section.
+    for comp_target in ctx.attr.components:
+        if UnitInfo in comp_target and ComponentInfo not in comp_target:
+            component_entries.append("units/" + comp_target.label.name)
+
     # Generate submodule links for the index page
     deps_links = _process_deps(ctx)
 

bazel/rules/rules_score/test/BUILD

@@ -47,6 +47,10 @@ load(
     "cross_label_collision_fails_test",
     "same_label_collision_fails_test",
 )
+load(
+    ":dependable_element_toplevel_unit_test.bzl",
+    "toplevel_unit_linked_test",
+)
 load(
     ":html_generation_test.bzl",
     "auto_config_generation_test",
@@ -919,6 +923,26 @@ dependable_element(
     deps = [],
 )
 
+# Unit listed directly in components (no parent component).
+dependable_element(
+    name = "toplevel_unit_example_lib",
+    testonly = True,
+    architectural_design = [":arch_design_leaf_unit_example"],
+    components = [":leaf_unit"],
+    dependability_analysis = [":dependability_analysis_target"],
+    integrity_level = "B",
+    maturity = "development",
+    requirements = [":feat_req"],
+    tests = [],
+    deps = [],
+)
+
+toplevel_unit_linked_test(
+    name = "toplevel_unit_linked_test",
+    target_under_test = ":toplevel_unit_example_lib_index",
+    unit_name = "leaf_unit",
+)
+
 sh_test(
     name = "leaf_unit_example_link_rendered_test",
     srcs = ["check_idmap_link.sh"],

bazel/rules/rules_score/test/dependable_element_toplevel_unit_test.bzl

@@ -0,0 +1,38 @@
+# *******************************************************************************
+# 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
+# *******************************************************************************
+"""Analysis test: units listed directly in dependable_element.components are linked in a toctree."""
+
+load("@bazel_skylib//lib:unittest.bzl", "analysistest", "asserts")
+
+def _toplevel_unit_linked_test_impl(ctx):
+    env = analysistest.begin(ctx)
+
+    actions = [
+        a
+        for a in analysistest.target_actions(env)
+        if a.mnemonic == "TemplateExpand" and a.outputs.to_list()[0].basename == "components.rst"
+    ]
+    asserts.equals(env, 1, len(actions))
+    if len(actions) == 1:
+        entries = {s: v for s, v in actions[0].substitutions.items()}["{entries}"]
+        asserts.true(
+            env,
+            "units/" + ctx.attr.unit_name in entries,
+            "top-level unit page missing from components toctree: " + entries,
+        )
+    return analysistest.end(env)
+
+toplevel_unit_linked_test = analysistest.make(
+    _toplevel_unit_linked_test_impl,
+    attrs = {"unit_name": attr.string(mandatory = True)},
+)