Docs rule preventing //... builds

[MaciejKaszynski]

Description

The bazel docs rule prevents builds of //... of a repo.

It seems that the docs rule internally creates a //:docs_combo_experimental target that is deprecated and then causes errors later on.

e.g.

In the lifecycle repo we only have the docs rule:
https://github.com/eclipse-score/lifecycle/blob/92b7ffeeeb36c598f3f3a64a72626b397e87e3db/BUILD#L94-L102

And building with bazel build --config=x86_64-linux //... causes the following.

WARNING: /home/kam1yok/score/lifecycle/BUILD:161:5: target '//:docs_combo_experimental' is deprecated: Target '//:docs_combo_experimental' is deprecated. Use '//:docs_combo' instead.
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/aes.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/c-libutl.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/cldr.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/icu.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/public_suffix.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/siphash.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.base/unicode.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.xml/bcel.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.xml/dom.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.xml/jcup.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.xml/schema10part1.md'
ERROR: /home/kam1yok/score/lifecycle/BUILD:161:5: //:docs_sources: missing input file '//:external/bazel_tools/jdk/legal/java.xml/schema10part2.md'
...

We are using docs-as-code version 4.6.0

Analysis results

No response

Solution

No response

Error Occurrence Rate

None

How to reproduce

No response

Supporting Information

No response

Classification

Minor

First Affected Release

not released (main)

Last Affected Release

not released (main)

Expected Fixed Release

before release (main)

Category

• Safety Relevant
• Security Relevant