upper_tabs:
- name: Versions
  menu:
  - column:
    - links:
      - include: /versions/_toc.yaml
  - column:
    - links:
      - label: "Nightly"
        path: /
      - label: "More…"
        path: /versions/
- name: Getting started
  heading: Getting started with Bazel
  lower_tabs:
    other:
    - name: Why Bazel?
      contents:
      - title: Overview
        path: /start/
      - title: Intro to Bazel
        path: /start/bazel-intro
      - title: Bazel vision
        path: /start/bazel-vision
      - title: Get started
        path: /start/getting-started
      - title: FAQ
        path: /faq
    - name: Install
      contents:
      - title: Overview
        path: /install
      - title: Install with Bazelisk
        path: /install/bazelisk
      - title: Fedora/CentOS
        path: /install/redhat
      - title: macOS
        path: /install/os-x
      - title: openSUSE
        path: /install/suse
      - title: Ubuntu
        path: /install/ubuntu
      - title: Windows
        path: /install/windows
      - title: Compile from source
        path: /install/compile-source
      - heading: Setting up your environment
      - title: Command-line completion
        path: /install/completion
      - title: Integrate with IDEs
        path: /install/ide
    - name: Migrate
      contents:
      - title: Overview
        path: /migrate/
      - title: Maven
        path: /migrate/maven
      - title: Xcode
        path: /migrate/xcode
      - title: CocoaPods
        path: /migrate/cocoapods
    - name: Tutorials
      contents:
      - heading: Build a project
      - title: C++
        path: /tutorials/cpp
      - title: C++ use cases
        path: /tutorials/cpp-use-cases
      - title: Java
        path: /tutorials/java
      - heading: Build an app
      - title: Android
        path: /tutorials/android-app
      - title: iOS
        path: /tutorials/ios-app
      - heading: Configure toolchains
      - title: Configure C++ toolchain
        path: /tutorials/cc-toolchain-config
- name: Basics
  heading: Build Basics
  lower_tabs:
    other:
    - name: Basics
      contents:
      - title: Overview
        path: /basics/
        status: new
      - title: Why a build system?
        path: /basics/build-systems
        status: new
      - title: Task-based builds
        path: /basics/task-based-builds
        status: new
      - title: Artifact-based builds
        path: /basics/artifact-based-builds
        status: new
      - title: Distributed builds
        path: /basics/distributed-builds
        status: new
      - title: Dependency management
        path: /basics/dependencies
        status: new
- name: Using
  heading: Using Bazel
  lower_tabs:
    other:
    - name: Build
      contents:
      - title: Overview
        path: /docs/
      - heading: Concepts
      - title: Workspaces, packages, & targets
        path: /concepts/build-ref
      - title: Labels
        path: /concepts/labels
      - title: BUILD files
        path: /concepts/build-files
      - title: Dependencies
        path: /concepts/dependencies
      - title: Visibility
        path: /concepts/visibility
      - title: Platforms
        path: /concepts/platforms-intro
      - title: Hermeticity
        path: /concepts/hermeticity
      - heading: Work with BUILD files
      - title: BUILD style guide
        path: /rules/build-style
      - title: Share variables
        path: /rules/tutorial-sharing-variables
      - title: Work with external dependencies
        path: /docs/external
      - title: Manage dependencies with Bzlmod
        path: /docs/bzlmod
        status: new
      - heading: Run Bazel
      - title: Build with Bazel
        path: /docs/build
      - title: Commands and options
        path: /docs/user-manual
      - title: Write bazelrc files
        path: /docs/bazelrc
      - title: Call Bazel from scripts
        path: /docs/scripts
      - title: Client/server implementation
        path: /docs/client-server
      - heading: Configure your build
      - title: Configurable attributes
        path: /docs/configurable-attributes
      - title: Integrate with C++ rules
        path: /docs/integrating-with-rules-cc
      - title: Toolchain resolution implementation
        path: /docs/toolchain_resolution_implementation
      - title: Code coverage with Bazel
        path: /docs/coverage
      - heading: Query your build
      - title: Query quickstart
        path: /docs/query-how-to
      - title: Query reference
        path: /reference/query
      - title: Action graph query (aquery)
        path: /docs/aquery
      - title: Configurable query (cquery)
        path: /docs/cquery
      - heading: Optimizing Bazel
      - title: Best practices
        path: /docs/best-practices
      - title: Optimize memory
        path: /docs/memory-saving-mode
      - title: Using Bazel on Windows
        path: /docs/windows
    - name: Extending Bazel
      contents:
      - title: Overview
        path: /rules/concepts
      - title: Recommended rules
        path: /rules/
      - heading: Rules concepts
      - title: Rules
        path: /rules/rules
      - title: Macros
        path: /rules/macros
      - title: Depsets
        path: /rules/depsets
      - title: Aspects
        path: /rules/aspects
      - title: Repository rules
        path: /rules/repository_rules
      - title: Configuring
        path: /rules/config
      - heading: Write rules
      - title: Rules tutorial
        path: /rules/rules-tutorial
      - title: Write rules on Windows
        path: /rules/windows_tips
      - title: Example rules
        path: https://github.com/bazelbuild/examples/tree/HEAD/rules
        status: external
      - title: Challenges
        path: /docs/rule-challenges
      - heading: Write macros
      - title: Create a macro
        path: /rules/tutorial-creating-a-macro
      - title: Create custom verbs
        path: /rules/tutorial-custom-verbs
      - heading: Test
      - title: Test rules
        path: /rules/testing
      - title: Lint
        path: https://github.com/bazelbuild/buildtools/tree/master/buildifier
        status: external
      - title: Optimize performance
        path: /rules/performance
      - heading: Rules authors
      - title: Deploy rules
        path: /rules/deploying
      - title: Document rules with Stardoc
        path: https://github.com/bazelbuild/stardoc
        status: external
    - name: Distributed builds
      contents:
      - heading: Remote execution
      - title: Overview
        path: /docs/remote-execution
      - title: Guidelines
        path: /docs/remote-execution-rules
      - title: Configure Bazel CI with remote execution
        path: /docs/remote-execution-ci
      - title: Dynamic execution
        path: /docs/dynamic-execution
      - heading: Troubleshooting
      - title: Troubleshoot with Docker Sandbox
        path: /docs/remote-execution-sandbox
      - title: Non-hermetic WORKSPACE rules
        path: /docs/workspace-log
      - title: Remote—Debug remote chaching
        path: /docs/remote-execution-caching-debug
      - heading: Remote caching
      - title: Overview
        path: /docs/remote-caching
      - title: Local—Debug remote chaching
        path: /docs/remote-caching-debug
      - heading: Persistent workers
      - title: Overview
        path: /docs/persistent-workers
      - title: Multiplex workers
        path: /docs/multiplex-worker
      - title: Create workers
        path: /docs/creating-workers
      - heading: Build Event Protocol
      - title: Overview
        path: /docs/build-event-protocol
      - title: BEP examples
        path: /docs/bep-examples
      - title: BEP glossary
        path: /docs/bep-glossary
- name: Reference
  heading: Reference
  lower_tabs:
    other:
    - name: Reference
      contents:
      - title: Overview
        path: /reference
      - title: Build encyclopedia
        include: /reference/be/_toc.yaml
      - title: Test encyclopedia
        path: /reference/test-encyclopedia
      - title: Command line reference
        path: /reference/command-line-reference
      - title: Query reference
        path: /reference/query
      - title: Execution groups
        path: /reference/exec-groups
      - title: Output directory layout
        path: /docs/output_directories
      - title: Platforms
        path: /docs/platforms
      - title: Toolchains
        path: /docs/toolchains
      - title: Skyframe
        path: /reference/skyframe
        status: new
      - title: Glossary
        path: /reference/glossary
    - name: Language
      contents:
      - heading: Build language
      - title: Starlark
        path: /rules/language
      - title: Starlark style guide
        path: /rules/bzl-style
      - title: Build API
        include: /rules/lib/_toc.yaml
    - name: Releases & Versions
      contents:
      - heading: Release
      - title: Understand releases
        path: /release/
      - title: Release versioning
        path: /release/versioning
      - title: Backward compatibility
        path: /release/backward-compatibility
      - heading: Versions
      - title: Choose a version
        path: /versions/
      - title: Update versions with Bazelisk
        path: /versions/updating-bazel
- name: Contributing
  heading: Contributing to Bazel
  lower_tabs:
    other:
    - name: Contributors
      contents:
      - title: Overview
        path: /contribute/
      - title: Contributor guide
        path: /contribute/guide
      - title: Start contributing
        path: /contribute/getting-started
      - title: Contribution policy
        path: /contribute/contribution-policy
      - title: Patch acceptance process
        path: /contribute/patch-acceptance
      - title: Special Interest Groups
        path: /contribute/sig
      - heading: Understand the codebase
      - title: Codebase guide
        path: https://github.com/bazelbuild/bazel/blob/master/CODEBASE.md
        status: external
      - title: Search the codebase
        path: /contribute/searching-codebase
      - heading: Contribute documentation
      - title: Contribute documentation
        path: /contribute/docs
      - title: Documentation style guide
        path: /contribute/docs-style-guide
    - name: Propose changes
      contents:
      - title: Write design documents
        path: /contribute/design-documents
      - title: Write release notes
        path: /contribute/release-notes
      - title: Nominate recommended rules
        path: /contribute/recommended-rules
      - title: Name Bazel projects
        path: /contribute/naming
      - title: Roll out breaking changes
        path: /contribute/breaking-changes
    - name: Support
      contents:
      - title: Get help
        path: /help
      - title: Support policy
        path: /contribute/support
      - heading: Community support
      - title: Community experts
        path: /community/experts/
      - title: Bazel users
        path: /community/users
      - title: Remote execution services
        path: /community/remote-execution-services
      - title: Roadmaps
        path: /community/roadmaps
    - name: Maintainers
      contents:
      - title: Maintainer guide
        path: /contribute/maintainers-guide
      - title: Maintaining Chocolatey on Windows
        path: /contribute/windows-chocolatey-maintenance
      - title: Bazel Scoop on Windows
        path: /contribute/windows-scoop-maintenance