fix(docs): use unique label names (#424)

PiotrKorkus · web-flow · commit 7f51a5848c8f · 2026-03-03T09:22:49.000+01:00
defensive against docs_combo_build
diff --git a/docs/concepts/bidirectional_traceability.rst b/docs/concepts/bidirectional_traceability.rst
@@ -1,4 +1,4 @@
-.. _bidirectional_traceability:
+.. _docs_bidirectional_traceability:
 
 Bi-directional Traceability
 ===========================
diff --git a/docs/concepts/index.rst b/docs/concepts/index.rst
@@ -1,4 +1,4 @@
-.. _concepts:
+.. _docs_concepts:
 
 Concepts
 ========
diff --git a/docs/how-to/index.rst b/docs/how-to/index.rst
@@ -1,4 +1,4 @@
-.. _how-to:
+.. _docs_how-to:
 
 How To
 ======
diff --git a/docs/how-to/other_modules.rst b/docs/how-to/other_modules.rst
@@ -42,7 +42,7 @@ Example `BUILD` snippet (consumer module):
       source_dir = "docs",
     )
 
-More details in :ref:`bidirectional_traceability`.
+More details in :ref:`docs_bidirectional_traceability`.
 
 3) Reference needs across modules
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/index.rst b/docs/index.rst
@@ -22,21 +22,21 @@ It provides documentation, requirements, and traceability.
 
    .. grid-item-card::
 
-      :ref:`How to <how-to>`
+      :ref:`How to <docs_how-to>`
       ^^^
       Learn how to integrate and use docs-as-code.
 
 
    .. grid-item-card::
 
-      :ref:`Reference <reference>`
+      :ref:`Reference <docs_reference>`
       ^^^
       API and usage reference.
 
 
    .. grid-item-card::
 
-      :ref:`Concepts <concepts>`
+      :ref:`Concepts <docs_concepts>`
       ^^^
       Key concepts, models and explanatory material to understand the system.
 
diff --git a/docs/internals/index.rst b/docs/internals/index.rst
@@ -1,4 +1,4 @@
-.. _internals:
+.. _docs_internals:
 
 Internals
 =========
diff --git a/docs/internals/requirements/implementation_state.rst b/docs/internals/requirements/implementation_state.rst
@@ -1,4 +1,4 @@
-.. _statistics:
+.. _docs_statistics:
 
 Implementation State Statistics
 ================================
diff --git a/docs/internals/requirements/process_overview.rst b/docs/internals/requirements/process_overview.rst
@@ -1,4 +1,4 @@
-.. _process_overview:
+.. _docs_process_overview:
 
 ===============================
 Process Requirements Overview
diff --git a/docs/internals/requirements/requirements.rst b/docs/internals/requirements/requirements.rst
@@ -1,4 +1,4 @@
-.. _tool_requirements:
+.. _docs_tool_requirements:
 
 =================================
 Tool Requirements
diff --git a/docs/reference/bazel_macros.rst b/docs/reference/bazel_macros.rst
@@ -1,4 +1,4 @@
-.. _bazel-macros:
+.. _docs_bazel-macros:
 
 Bazel macro: ``docs``
 =====================
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
@@ -1,4 +1,4 @@
-.. _reference:
+.. _docs_reference:
 
 Reference
 =========

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _bidirectional_traceability:`
	`1`	`+.. _docs_bidirectional_traceability:`
`2`	`2`
`3`	`3`	`Bi-directional Traceability`
`4`	`4`	`===========================`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _concepts:`
	`1`	`+.. _docs_concepts:`
`2`	`2`
`3`	`3`	`Concepts`
`4`	`4`	`========`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _how-to:`
	`1`	`+.. _docs_how-to:`
`2`	`2`
`3`	`3`	`How To`
`4`	`4`	`======`
Original file line number	Diff line number	Diff line change
@@ -42,7 +42,7 @@ Example `BUILD` snippet (consumer module):
`42`	`42`	`source_dir = "docs",`
`43`	`43`	`)`
`44`	`44`
`45`		-More details in :ref:`bidirectional_traceability`.
	`45`	+More details in :ref:`docs_bidirectional_traceability`.
`46`	`46`
`47`	`47`	`3) Reference needs across modules`
`48`	`48`	`~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _internals:`
	`1`	`+.. _docs_internals:`
`2`	`2`
`3`	`3`	`Internals`
`4`	`4`	`=========`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _statistics:`
	`1`	`+.. _docs_statistics:`
`2`	`2`
`3`	`3`	`Implementation State Statistics`
`4`	`4`	`================================`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _process_overview:`
	`1`	`+.. _docs_process_overview:`
`2`	`2`
`3`	`3`	`===============================`
`4`	`4`	`Process Requirements Overview`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _tool_requirements:`
	`1`	`+.. _docs_tool_requirements:`
`2`	`2`
`3`	`3`	`=================================`
`4`	`4`	`Tool Requirements`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _bazel-macros:`
	`1`	`+.. _docs_bazel-macros:`
`2`	`2`
`3`	`3`	Bazel macro: ``docs``
`4`	`4`	`=====================`