Update the docs navigation

​

How navigation works

{
  "navigation": [
    {
      "group": "Contribute",
      "pages": [
        "contribute/index",
        "contribute/docs-contribution-workflow",
        "contribute/docs-style-guide"
      ]
    }
  ]
}

​

Prerequisites

• A fork of bazel-contrib/bazel-docs
• The Mintlify CLI for local validation

​

Add a page to an existing group

1. Clone your fork of bazel-contrib/bazel-docs and add the upstream remote:
   git clone https://github.com/YOUR_USERNAME/bazel-docs.git
   cd bazel-docs
   git remote add upstream https://github.com/bazel-contrib/bazel-docs.git
   
2. Check out a new branch:
   git fetch upstream
   git checkout -b add-my-page-to-nav upstream/main
   
3. Open docs.json and find the group where your page belongs. Add the path to the pages array:
   {
     "group": "Contribute",
     "pages": [
       "contribute/index",
       "contribute/docs-contribution-workflow",
       "contribute/docs-navigation",
       "contribute/docs-style-guide"
     ]
   }
   
4. Validate that docs.json is well-formed:
   mint validate
   
   Run this from the bazel-docs root (where docs.json lives).
5. Commit and open a PR against bazel-contrib/bazel-docs main:
   git add docs.json
   git commit -m "docs: Add my-page to navigation"
   git push origin add-my-page-to-nav
   
   Open a pull request targeting bazel-contrib/bazel-docs main.

​

Add a new navigation group

{
  "group": "My New Section",
  "pages": [
    "my-section/index",
    "my-section/getting-started"
  ]
}

​

Getting help