Host Bazel’s Devsite docs on a Mintlify site for easy modification.
This tool implements the improvements outlined in Bazel Docs: Why It Might Be Time For A Refresh. The goal is to create a more developer friendly set of Bazel Docs. Starting with bazel.build/docs
- Clones the Devsite source from
bazel.build/docsusing a git submodule. - Transforms Devsite frontmatter and directory layout into MDX format.
- Hosted on Mintlify
Clone the submodule: git submodule update --init -- upstream
Run the converter tool: TODO
Install the Mintlify dev tool: npm install -g mint
Then run mint dev to get a locally-running site.
Send a PR to get a hosted preview of the changes.