Documentation for certain rules is missing

[uri-canva]

Description of the problem / feature request:

Documentation for certain rules (for example java_toolchain) is missing on latest docs.build.bazel.

Feature requests: what underlying problem are you trying to solve with this feature?

Read the docs.

Bugs: what's the simplest, easiest way to reproduce this bug? Please provide a minimal example if possible.

https://docs.bazel.build/versions/master/be/java.html

Note the missing java_toolchain, compare with:

https://web.archive.org/web/20181021162843/https://docs.bazel.build/versions/master/be/java.html

The source of the docs still exists on current master, so I don't think it's been removed intentionally:

bazel/src/main/java/com/google/devtools/build/lib/rules/java/JavaToolchainRule.java

Line 269 in 91e0bae

<!-- #END_BLAZE_RULE -->*/

[jin]

cc @lberki

[jin]

Doc for java_import is also broken:

0.20.0: https://docs.bazel.build/versions/0.20.0/be/java.html#java_import

java_import(name, deps, data, compatible_with, constraints, deprecation, distribs, exports, features, jars, licenses, neverlink, proguard_specs, restricted_to, runtime_deps, srcjar, tags, testonly, visibility)

0.21.0: https://docs.bazel.build/versions/0.21.0/be/java.html#java_import

java_import(name, deps, data, compatible_with, deprecation, distribs, exports, features, licenses, restricted_to, runtime_deps, tags, testonly, visibility)

[jin]

cc @iirina @buchgr @fweikert

[Profpatsch]

Please fix this, not finding this rule in the documentation cost me a considerable amount of time. 😢
Writing docs for implemented code is not all that that much work compared to writing the code in the first place.

[jin]

Bisected to c1d7672.

jingwen@jingwen:/tmp
$ curl http://localhost:12345/versions/master/be/overview.html | grep java_runtime
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--100 37307  100 37307    0     0  2602k      0 --:--:-- --:--:-- --:--:-- 2802k

At 1db9e66, the commit before c1d7672

jingwen@jingwen:/tmp
$ curl http://localhost:12345/versions/master/be/overview.html | grep java_runtime
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--100 37666  100 37666    0     0  2627k      0 --:--:-                <a href="  java.html#java_runtime">
-             java_runtime
--:--:-- --:--:-- 2627k

[jin]

cc @cushon

[jin]

Fix: #7061