bazel.build missing /rules/lib/ docs in site/en

[alan707]

Note

This not an issue with alan707/bazel-docs repo, but rather an upstream issue with the https://bazel.build website missing parts not captured in the source code.

---

Problem Statement
Some links in the Bazel documentation (for example under /rules/lib/) do not function properly when converting from source because those parts of the site are not included in the site/en source tree (https://github.com/bazelbuild/bazel/tree/master/site/en). Instead, the converter has to redirect requests for these paths to the live https://bazel.build site.

Concrete Example

• The /rules/lib/ content appears to be generated API documentation that does not live in site/en.
• Workaround was to point to bazel.build/rules/lib/repo

Why This Matters

• There seems to be some missing pieces of the Bazel website outside of the Bazelbuild github repo

Proposed Fixes / Scope

• Add the missing devsite files to Bazelbuild github repo

[fweikert]

The docs under /rules/lib and /reference/be are generated from annotations in Bazel's Java code. You can produce them by building //src/main/java/com/google/devtools/build/lib:reference-docs.zip

Currently we operate our own pipeline that builds these Markdown files and pushes them to DevSite every night. That's the pipeline that I alluded to in our meeting, but I cannot find any mentions in the notes :(

[alan707]

Fixed by #66