Offer :docs_combo (#441)

Deprecate :docs_combo_experimental

Author: a-zw

docs.bzl

@@ -192,8 +192,8 @@ def docs(source_dir = "docs", data = [], deps = [], scan_code = []):
     )
 
     py_binary(
-        name = "docs_combo_experimental",
-        tags = ["cli_help=Build full documentation with all dependencies:\nbazel run //:docs_combo_experimental"],
+        name = "docs_combo",
+        tags = ["cli_help=Build full documentation with all dependencies:\nbazel run //:docs_combo"],
         srcs = ["@score_docs_as_code//src:incremental.py"],
         data = data_with_docs_sources + [":merged_sourcelinks"],
         deps = deps,
@@ -205,6 +205,12 @@ def docs(source_dir = "docs", data = [], deps = [], scan_code = []):
         },
     )
 
+    native.alias(
+        name = "docs_combo_experimental",
+        actual = ":docs_combo",
+        deprecation = "Target '//:docs_combo_experimental' is deprecated. Use '//:docs_combo' instead.",
+    )
+
     py_binary(
         name = "docs_link_check",
         tags = ["cli_help=Verify Links inside Documentation:\nbazel run //:link_check\n (Note: this could take a long time)"],

docs/concepts/bidirectional_traceability.rst

@@ -40,7 +40,7 @@ Build with copies
 
 .. code-block:: sh
 
-   bazel run //:docs_combo_experimental
+	bazel run //:docs_combo
 
 The documentation build does not depend on the needs.json but on whole documentation source code.
 

docs/reference/commands.md

@@ -4,7 +4,7 @@
 | ---------------------------------------------- | ------------------------------------------------------------------------------------------------- |
 | `bazel run //:docs`                            | Builds documentation                                                                              |
 | `bazel run //:docs_check`                      | Verifies documentation correctness                                                                |
-| `bazel run //:docs_combo_experimental`         | Builds combined documentation with all external dependencies included                             |
+| `bazel run //:docs_combo`                      | Builds combined documentation with all external dependencies included                             |
 | `bazel run //:live_preview`                    | Creates a live_preview of the documentation viewable in a local server                            |
 | `bazel run //:live_preview_combo_experimental` | Creates a live_preview of the full documentation with all dependencies viewable in a local server |
 | `bazel run //:ide_support`                     | Sets up a Python venv for esbonio (Remember to restart VS Code!)                                  |