Docs: Created top-level Getting started section in docs.bazel.build. Iterative updates to Bazel navigation.
PiperOrigin-RevId: 358305641
diff --git a/site/_config.yml b/site/_config.yml
index 89dc745..9225abb 100644
--- a/site/_config.yml
+++ b/site/_config.yml
@@ -54,7 +54,8 @@
- 0.17.1
main_site_url: https://www.bazel.build
-docs_site_url: "/"
+getting_started_category_url: "/"
+docs_site_url: "/guide.html"
blog_site_url: https://blog.bazel.build
defaults:
@@ -65,6 +66,11 @@
values:
toc: true
sitemap: true
+ -
+ scope:
+ type: "pages"
+ values:
+ category: "documentation"
# jekyll-toc settings
toc:
diff --git a/site/_includes/documentation-sidebar/4/sidebar.html b/site/_includes/documentation-sidebar/4/sidebar.html
index 0cc4b85..62c09ff 100644
--- a/site/_includes/documentation-sidebar/4/sidebar.html
+++ b/site/_includes/documentation-sidebar/4/sidebar.html
@@ -1,228 +1,142 @@
-<h3>Home</h3>
+<h3>Guides</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/guide.html">Running Bazel</a></li>
+ <li><a href="/versions/{{ current_version }}/memory-saving-mode.html">Optimizing Memory</a></li>
+ <li><a href="/versions/{{ current_version }}/windows.html">Building on Windows</a></li>
+ <li><a href="/versions/{{ current_version }}/best-practices.html">Best practices</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/tutorial-sharing-variables.html">Sharing BUILD Variables</a></li>
+ </ul>
+
+<h3>Rules and Macros</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/rules.html">Understanding Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/rules-tutorial.html">Writing Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/rule-challenges.html">Rules Challenges</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/tutorial-creating-a-macro.html">Creating a Macro</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/tutorial-custom-verbs.html">Creating Custom Verbs</a></li>
+ </ul>
+
+<h3>Query for Dependencies</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/query-how-to.html">Query Quickstart</a></li>
+ <li><a href="/versions/{{ current_version }}/cquery.html">Query Build Options</a></li>
+ <li><a href="/versions/{{ current_version }}/aquery.html">Query Action Graph</a></li>
+ <li><a href="/versions/{{ current_version }}/query.html">Query Reference</a></li>
+ </ul>
+
+<h3>Remote execution</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/remote-execution.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/remote-execution-rules.html">Guidelines</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#troubleshoot-remote-execution-menu" aria-expanded="false"
+ aria-controls="troubleshoot-remote-execution-menu">
+ Troubleshooting<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="troubleshoot-remote-execution-menu">
+ <li><a href="/versions/{{ current_version }}/remote-execution-sandbox.html">Troubleshooting with Bazel Sandbox</a></li>
+ <li><a href="/versions/{{ current_version }}/workspace-log.html">Non-Hermetic WORKSPACE Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/remote-execution-caching-debug.html">Debugging Remote Cache Hits</a></li>
+ </ul>
+ </li>
+ <li><a href="/versions/{{ current_version }}/remote-execution-ci.html">Remote Execution and CI</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#remote-caching-menu" aria-expanded="false"
+ aria-controls="remote-caching-menu">
+ Remote caching<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="remote-caching-menu">
+ <li><a href="/versions/{{ current_version }}/remote-caching.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/remote-caching-debug.html">Debugging</a></li>
+ </ul>
+ </li>
+ </ul>
+
+
+<h3>Extending Bazel</h3>
<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/bazel-overview.html">Bazel overview</a></li>
- <li><a href="/versions/{{ current_version }}/bazel-vision.html">Bazel vision</a></li>
- <li><a href="/versions/{{ current_version }}/getting-started.html">Getting started</a></li>
- <li><a href="/versions/{{ current_version }}/backward-compatibility.html">Backward compatibility</a></li>
-</ul>
+ <li><a href="/versions/{{ current_version }}/skylark/concepts.html">Overview</a></li>
-<h3>Installing Bazel</h3>
-<ul class="sidebar-nav">
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#starlark-concepts" aria-expanded="false"
+ aria-controls="starlark-concepts">
+ Concepts<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-concepts">
+ <li><a href="/versions/{{ current_version }}/skylark/macros.html">Macros</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/rules.html">Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/depsets.html">Depsets</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/aspects.html">Aspects</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/repository_rules.html">Repository Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/config.html">Configurations</a></li>
+ </ul>
+ </li>
- <li class="sidebar-nav">
- <a href="/versions/{{ current_version }}/install.html">Installation overview</a>
- </li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#starlark-practices" aria-expanded="false"
+ aria-controls="starlark-practices">
+ Best practices<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-practices">
+ <li><a href="/versions/{{ current_version }}/skylark/bzl-style.html">.bzl Style Guide</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/testing.html">Testing Extensions</a></li>
+ <li><a href="https://github.com/bazelbuild/stardoc">Documenting Rules with Stardoc</a></li>
+ <li><a href="https://github.com/bazelbuild/buildtools/tree/master/buildifier">Linting</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/performance.html">Optimizing Performance</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/deploying.html">Deploying Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/windows_tips.html">Writing Rules on Windows</a></li>
+ </ul>
+ </li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#installing-menu" aria-expanded="false"
- aria-controls="installing-menu">
- Installation steps<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="installing-menu">
+ <li><a href="https://github.com/bazelbuild/examples/tree/master/rules">Examples</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/lib/skylark-overview.html">Extensions API</a></li>
- <li><a href="/versions/{{ current_version }}/install-ubuntu.html">Ubuntu</a></li>
- <li><a href="/versions/{{ current_version }}/install-redhat.html">Fedora/CentOS</a></li>
- <li><a href="/versions/{{ current_version }}/install-os-x.html">macOS</a></li>
- <li><a href="/versions/{{ current_version }}/install-windows.html">Windows</a></li>
- <li><a href="/versions/{{ current_version }}/install-compile-source.html">Compiling from source</a></li>
- <li><a href="/versions/{{ current_version }}/completion.html">Command-line completion</a></li>
- <li><a href="/versions/{{ current_version }}/ide.html">Integrating with IDEs</a></li>
- </ul>
- </li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#persistent-workers" aria-expanded="false"
+ aria-controls="persistent-workers">
+ Persistent Workers<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="persistent-workers">
+ <li><a href="/versions/{{ current_version }}/persistent-workers.html">Persistent Workers</a></li>
+ <li><a href="/versions/{{ current_version }}/multiplex-worker.html">Multiplex Workers</a></li>
+ <li><a href="/versions/{{ current_version }}/creating-workers.html">Creating Persistent Workers</a></li>
+ </ul>
+ </li>
- <li class="sidebar-nav">
- <a href="/versions/{{ current_version }}/updating-bazel.html">Updating Bazel</a>
- </li>
-</ul>
-
-<h3>Tutorials</h3>
-<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/tutorial/cpp.html">C++</a></li>
- <li><a href="/versions/{{ current_version }}/tutorial/java.html">Java</a></li>
- <li><a href="/versions/{{ current_version }}/tutorial/android-app.html">Android</a></li>
- <li><a href="/versions/{{ current_version }}/tutorial/ios-app.html">iOS</a></li>
-</ul>
-
-<h3>Using Bazel</h3>
-<ul class="sidebar-nav">
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#using-menu" aria-expanded="false"
- aria-controls="using-menu">
- Concepts<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="using-menu">
- <li><a href="/versions/{{ current_version }}/build-ref.html">Core concepts</a></li>
- <li><a href="/versions/{{ current_version }}/external.html">External dependencies</a></li>
- <li><a href="/versions/{{ current_version }}/configurable-attributes.html">Configurable attributes</a></li>
- <li><a href="/versions/master/platforms-intro.html">Platforms and toolchains</a></li>
- <li><a href="/versions/master/visibility.html">Visibility</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#guides-menu" aria-expanded="false"
- aria-controls="build-files-menu">
- Guides<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="guides-menu">
- <li><a href="/versions/{{ current_version }}/guide.html">Running Bazel</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/tutorial-creating-a-macro.html">Creating a macro</a></li>
- <li><a href="/versions/{{ current_version }}/memory-saving-mode.html">Optimizing memory</a></li>
- <li><a href="/versions/{{ current_version }}/windows.html">Building on Windows</a></li>
- </ul>
- </li>
-
- <li><a href="/versions/{{ current_version }}/rules.html">Rules</a></li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#query-menu" aria-expanded="false"
- aria-controls="query-menu">
- Queries<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="query-menu">
- <li><a href="/versions/{{ current_version }}/query-how-to.html">The query command</a></li>
- <li><a href="/versions/{{ current_version }}/cquery.html">The cquery command</a></li>
- <li><a href="/versions/{{ current_version }}/aquery.html">The aquery command</a></li>
- <li><a href="/versions/{{ current_version }}/query.html">Query language</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#best-practices-menu" aria-expanded="false"
- aria-controls="best-practices-menu">
- Best practices<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="best-practices-menu">
- <li><a href="/versions/{{ current_version }}/best-practices.html">General best practices</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/tutorial-sharing-variables.html">Sharing BUILD variables</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#remote-execution-menu" aria-expanded="false"
- aria-controls="remote-execution-menu">
- Remote execution<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="remote-execution-menu">
- <li><a href="/versions/{{ current_version }}/remote-execution.html">Overview</a></li>
- <li><a href="/versions/{{ current_version }}/remote-execution-rules.html">Guidelines</a></li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#troubleshoot-remote-execution-menu" aria-expanded="false"
- aria-controls="troubleshoot-remote-execution-menu">
- Troubleshooting<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="troubleshoot-remote-execution-menu">
- <li><a href="/versions/{{ current_version }}/remote-execution-sandbox.html">Troubleshooting with Bazel sandbox</a></li>
- <li><a href="/versions/{{ current_version }}/workspace-log.html">Non-hermetic WORKSPACE rules</a></li>
- <li><a href="/versions/{{ current_version }}/remote-execution-caching-debug.html">Debugging remote cache hits</a></li>
- </ul>
- </li>
- <li><a href="/versions/{{ current_version }}/remote-execution-ci.html">Remote execution and CI</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#remote-caching-menu" aria-expanded="false"
- aria-controls="remote-caching-menu">
- Remote caching<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="remote-caching-menu">
- <li><a href="/versions/{{ current_version }}/remote-caching.html">Overview</a></li>
- <li><a href="/versions/{{ current_version }}/remote-caching-debug.html">Debugging remote cache hits with local execution</a></li>
- </ul>
- </li>
+ <li><a href="/versions/{{ current_version }}/skylark/rules-tutorial.html">Rules tutorial</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/faq.html">FAQ</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/language.html">Starlark Language</a></li>
</ul>
<h3>Reference</h3>
<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/user-manual.html">Commands and options</a></li>
- <li><a href="/versions/{{ current_version }}/glossary.html">Glossary</a></li>
- <li><a href="/versions/{{ current_version }}/be/overview.html">Build encyclopedia</a></li>
- <li><a href="/versions/{{ current_version }}/test-encyclopedia.html">Test encyclopedia</a></li>
- <li><a href="/versions/{{ current_version }}/command-line-reference.html">Command line reference</a></li>
+ <li><a href="/versions/{{ current_version }}/user-manual.html">Commands and Options</a></li>
+ <li><a href="/versions/{{ current_version }}/be/overview.html">Build Encyclopedia</a></li>
+ <li><a href="/versions/{{ current_version }}/test-encyclopedia.html">Test Encyclopedia</a></li>
+ <li><a href="/versions/{{ current_version }}/command-line-reference.html">Command Line Reference</a></li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#build-files-menu" aria-expanded="false"
- aria-controls="build-files-menu">
- BUILD files<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="build-files-menu">
- <li><a href="/versions/{{ current_version }}/be/functions.html">Functions</a></li>
- <li><a href="/versions/{{ current_version }}/be/common-definitions.html">Common rule definitions</a></li>
- <li><a href="/versions/{{ current_version }}/be/make-variables.html">"Make" variables</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/build-style.html">BUILD style guide</a></li>
- </ul>
- </li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#build-files-menu" aria-expanded="false"
+ aria-controls="build-files-menu">
+ BUILD Files<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="build-files-menu">
+ <li><a href="/versions/{{ current_version }}/be/functions.html">Functions</a></li>
+ <li><a href="/versions/{{ current_version }}/be/common-definitions.html">Common Rule Definitions</a></li>
+ <li><a href="/versions/{{ current_version }}/be/make-variables.html">"Make" Variables</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/build-style.html">BUILD Style Guide</a></li>
+ </ul>
+ </li>
- <li><a href="/versions/{{ current_version }}/build-event-protocol.html">Build Event Protocol</a></li>
- <li><a href="/versions/{{ current_version }}/output_directories.html">Output directory layout</a></li>
- <li><a href="/versions/{{ current_version }}/platforms.html">Platforms</a></li>
- <li><a href="/versions/{{ current_version }}/exec-groups.html">Execution Groups</a></li>
- <li><a href="/versions/{{ current_version }}/toolchains.html">Toolchains</a></li>
-</ul>
-
-<h3>Extending Bazel</h3>
-<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/skylark/concepts.html">Extension overview</a></li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#starlark-concepts" aria-expanded="false"
- aria-controls="starlark-concepts">
- Concepts<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-concepts">
- <li><a href="/versions/{{ current_version }}/skylark/macros.html">Macros</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/rules.html">Rules</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/depsets.html">Depsets</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/aspects.html">Aspects</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/repository_rules.html">Repository rules</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/config.html">Configurations</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#starlark-practices" aria-expanded="false"
- aria-controls="starlark-practices">
- Best practices<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-practices">
- <li><a href="/versions/{{ current_version }}/skylark/bzl-style.html">.bzl style guide</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/testing.html">Testing extensions</a></li>
- <li><a href="https://github.com/bazelbuild/stardoc">Documenting rules with Stardoc</a></li>
- <li><a href="https://github.com/bazelbuild/buildtools/tree/master/buildifier">Linting</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/performance.html">Optimizing performance</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/deploying.html">Deploying rules</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/windows_tips.html">Writing rules on Windows</a></li>
- </ul>
- </li>
-
- <li><a href="https://github.com/bazelbuild/examples/tree/master/rules">Examples</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/lib/skylark-overview.html">Extensions API</a></li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#persistent-workers" aria-expanded="false"
- aria-controls="persistent-workers">
- Persistent workers<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="persistent-workers">
- <li><a href="/versions/{{ current_version }}/persistent-workers.html">Persistent workers</a></li>
- <li><a href="/versions/{{ current_version }}/multiplex-worker.html">Multiplex workers</a></li>
- <li><a href="/versions/{{ current_version }}/creating-workers.html">Creating persistent workers</a></li>
- </ul>
- </li>
-
- <li><a href="/versions/{{ current_version }}/skylark/faq.html">FAQ</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/language.html">Starlark language</a></li>
+ <li><a href="/versions/{{ current_version }}/build-event-protocol.html">Build Event Protocol</a></li>
+ <li><a href="/versions/{{ current_version }}/output_directories.html">Output Directory Layout</a></li>
+ <li><a href="/versions/{{ current_version }}/platforms.html">Platforms</a></li>
+ <li><a href="/versions/{{ current_version }}/exec-groups.html">Execution Groups</a></li>
+ <li><a href="/versions/{{ current_version }}/toolchains.html">Toolchains</a></li>
</ul>
diff --git a/site/_includes/documentation-sidebar/master/sidebar.html b/site/_includes/documentation-sidebar/master/sidebar.html
index f8be2df..9b4412e 100644
--- a/site/_includes/documentation-sidebar/master/sidebar.html
+++ b/site/_includes/documentation-sidebar/master/sidebar.html
@@ -1,241 +1,152 @@
-<h3>Home</h3>
+<h3>Guides</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/guide.html">Running Bazel</a></li>
+ <li><a href="/versions/{{ current_version }}/memory-saving-mode.html">Optimizing Memory</a></li>
+ <li><a href="/versions/{{ current_version }}/windows.html">Building on Windows</a></li>
+ <li><a href="/versions/{{ current_version }}/best-practices.html">Best practices</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/tutorial-sharing-variables.html">Sharing BUILD Variables</a></li>
+ </ul>
+
+<h3>Rules and Macros</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/rules.html">Understanding Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/rules-tutorial.html">Writing Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/rule-challenges.html">Rules Challenges</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/tutorial-creating-a-macro.html">Creating a Macro</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/tutorial-custom-verbs.html">Creating Custom Verbs</a></li>
+ </ul>
+
+<h3>Query for Dependencies</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/query-how-to.html">Query Quickstart</a></li>
+ <li><a href="/versions/{{ current_version }}/cquery.html">Query Build Options</a></li>
+ <li><a href="/versions/{{ current_version }}/aquery.html">Query Action Graph</a></li>
+ <li><a href="/versions/{{ current_version }}/query.html">Query Reference</a></li>
+ </ul>
+
+<h3>Remote execution</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/remote-execution.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/remote-execution-rules.html">Guidelines</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#troubleshoot-remote-execution-menu" aria-expanded="false"
+ aria-controls="troubleshoot-remote-execution-menu">
+ Troubleshooting<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="troubleshoot-remote-execution-menu">
+ <li><a href="/versions/{{ current_version }}/remote-execution-sandbox.html">Troubleshooting with Bazel Sandbox</a></li>
+ <li><a href="/versions/{{ current_version }}/workspace-log.html">Non-Hermetic WORKSPACE Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/remote-execution-caching-debug.html">Debugging Remote Cache Hits</a></li>
+ </ul>
+ </li>
+ <li><a href="/versions/{{ current_version }}/remote-execution-ci.html">Remote Execution and CI</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#remote-caching-menu" aria-expanded="false"
+ aria-controls="remote-caching-menu">
+ Remote caching<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="remote-caching-menu">
+ <li><a href="/versions/{{ current_version }}/remote-caching.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/remote-caching-debug.html">Debugging</a></li>
+ </ul>
+ </li>
+ </ul>
+
+
+<h3>Extending Bazel</h3>
<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/bazel-overview.html">Bazel overview</a></li>
- <li><a href="/versions/{{ current_version }}/bazel-vision.html">Bazel vision</a></li>
- <li><a href="/versions/{{ current_version }}/getting-started.html">Getting started</a></li>
- <li><a href="/versions/{{ current_version }}/backward-compatibility.html">Backward compatibility</a></li>
- <li><a href="/versions/{{ current_version }}/versioning.html">Release versioning</a></li>
-</ul>
+ <li><a href="/versions/{{ current_version }}/skylark/concepts.html">Overview</a></li>
-<h3>Installing Bazel</h3>
-<ul class="sidebar-nav">
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#starlark-concepts" aria-expanded="false"
+ aria-controls="starlark-concepts">
+ Concepts<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-concepts">
+ <li><a href="/versions/{{ current_version }}/skylark/macros.html">Macros</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/rules.html">Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/depsets.html">Depsets</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/aspects.html">Aspects</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/repository_rules.html">Repository Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/config.html">Configurations</a></li>
+ </ul>
+ </li>
- <li class="sidebar-nav">
- <a href="/versions/{{ current_version }}/install.html">Installation overview</a>
- </li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#starlark-practices" aria-expanded="false"
+ aria-controls="starlark-practices">
+ Best practices<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-practices">
+ <li><a href="/versions/{{ current_version }}/skylark/bzl-style.html">.bzl Style Guide</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/testing.html">Testing Extensions</a></li>
+ <li><a href="https://github.com/bazelbuild/stardoc">Documenting Rules with Stardoc</a></li>
+ <li><a href="https://github.com/bazelbuild/buildtools/tree/master/buildifier">Linting</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/performance.html">Optimizing Performance</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/deploying.html">Deploying Rules</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/windows_tips.html">Writing Rules on Windows</a></li>
+ </ul>
+ </li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#installing-menu" aria-expanded="false"
- aria-controls="installing-menu">
- Installation steps<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="installing-menu">
+ <li><a href="https://github.com/bazelbuild/examples/tree/master/rules">Examples</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/lib/skylark-overview.html">Extensions API</a></li>
- <li><a href="/versions/{{ current_version }}/install-ubuntu.html">Ubuntu</a></li>
- <li><a href="/versions/{{ current_version }}/install-redhat.html">Fedora/CentOS</a></li>
- <li><a href="/versions/{{ current_version }}/install-os-x.html">macOS</a></li>
- <li><a href="/versions/{{ current_version }}/install-windows.html">Windows</a></li>
- <li><a href="/versions/{{ current_version }}/install-compile-source.html">Compiling from source</a></li>
- <li><a href="/versions/{{ current_version }}/completion.html">Command-line completion</a></li>
- <li><a href="/versions/{{ current_version }}/ide.html">Integrating with IDEs</a></li>
- </ul>
- </li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#persistent-workers" aria-expanded="false"
+ aria-controls="persistent-workers">
+ Persistent Workers<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="persistent-workers">
+ <li><a href="/versions/{{ current_version }}/persistent-workers.html">Persistent Workers</a></li>
+ <li><a href="/versions/{{ current_version }}/multiplex-worker.html">Multiplex Workers</a></li>
+ <li><a href="/versions/{{ current_version }}/creating-workers.html">Creating Persistent Workers</a></li>
+ </ul>
+ </li>
- <li class="sidebar-nav">
- <a href="/versions/{{ current_version }}/updating-bazel.html">Updating Bazel</a>
- </li>
-</ul>
-
-<h3>Tutorials</h3>
-<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/tutorial/cpp.html">C++</a></li>
- <li><a href="/versions/{{ current_version }}/tutorial/java.html">Java</a></li>
- <li><a href="/versions/{{ current_version }}/tutorial/android-app.html">Android</a></li>
- <li><a href="/versions/{{ current_version }}/tutorial/ios-app.html">iOS</a></li>
-</ul>
-
-<h3>Using Bazel</h3>
-<ul class="sidebar-nav">
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#using-menu" aria-expanded="false"
- aria-controls="using-menu">
- Concepts<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="using-menu">
- <li><a href="/versions/{{ current_version }}/build-ref.html">Core concepts</a></li>
- <li><a href="/versions/{{ current_version }}/external.html">External dependencies</a></li>
- <li><a href="/versions/{{ current_version }}/configurable-attributes.html">Configurable attributes</a></li>
- <li><a href="/versions/master/platforms-intro.html">Platforms and toolchains</a></li>
- <li><a href="/versions/master/visibility.html">Visibility</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#guides-menu" aria-expanded="false"
- aria-controls="build-files-menu">
- Guides<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="guides-menu">
- <li><a href="/versions/{{ current_version }}/guide.html">Running Bazel</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/tutorial-creating-a-macro.html">Creating a macro</a></li>
- <li><a href="/versions/{{ current_version }}/memory-saving-mode.html">Optimizing memory</a></li>
- <li><a href="/versions/{{ current_version }}/windows.html">Building on Windows</a></li>
- </ul>
- </li>
-
- <li><a href="/versions/{{ current_version }}/rules.html">Rules</a></li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#query-menu" aria-expanded="false"
- aria-controls="query-menu">
- Queries<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="query-menu">
- <li><a href="/versions/{{ current_version }}/query-how-to.html">The query command</a></li>
- <li><a href="/versions/{{ current_version }}/cquery.html">The cquery command</a></li>
- <li><a href="/versions/{{ current_version }}/aquery.html">The aquery command</a></li>
- <li><a href="/versions/{{ current_version }}/query.html">Query language</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#best-practices-menu" aria-expanded="false"
- aria-controls="best-practices-menu">
- Best practices<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="best-practices-menu">
- <li><a href="/versions/{{ current_version }}/best-practices.html">General best practices</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/tutorial-sharing-variables.html">Sharing BUILD variables</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#remote-execution-menu" aria-expanded="false"
- aria-controls="remote-execution-menu">
- Remote execution<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="remote-execution-menu">
- <li><a href="/versions/{{ current_version }}/remote-execution.html">Overview</a></li>
- <li><a href="/versions/{{ current_version }}/remote-execution-rules.html">Guidelines</a></li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#troubleshoot-remote-execution-menu" aria-expanded="false"
- aria-controls="troubleshoot-remote-execution-menu">
- Troubleshooting<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="troubleshoot-remote-execution-menu">
- <li><a href="/versions/{{ current_version }}/remote-execution-sandbox.html">Troubleshooting with Bazel sandbox</a></li>
- <li><a href="/versions/{{ current_version }}/workspace-log.html">Non-hermetic WORKSPACE rules</a></li>
- <li><a href="/versions/{{ current_version }}/remote-execution-caching-debug.html">Debugging remote cache hits</a></li>
- </ul>
- </li>
- <li><a href="/versions/{{ current_version }}/remote-execution-ci.html">Remote execution and CI</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#remote-caching-menu" aria-expanded="false"
- aria-controls="remote-caching-menu">
- Remote caching<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="remote-caching-menu">
- <li><a href="/versions/{{ current_version }}/remote-caching.html">Overview</a></li>
- <li><a href="/versions/{{ current_version }}/remote-caching-debug.html">Debugging remote cache hits with local execution</a></li>
- </ul>
- </li>
+ <li><a href="/versions/{{ current_version }}/skylark/rules-tutorial.html">Rules tutorial</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/faq.html">FAQ</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/language.html">Starlark Language</a></li>
</ul>
<h3>Reference</h3>
<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/user-manual.html">Commands and options</a></li>
- <li><a href="/versions/{{ current_version }}/glossary.html">Glossary</a></li>
- <li><a href="/versions/{{ current_version }}/be/overview.html">Build encyclopedia</a></li>
- <li><a href="/versions/{{ current_version }}/test-encyclopedia.html">Test encyclopedia</a></li>
- <li><a href="/versions/{{ current_version }}/command-line-reference.html">Command line reference</a></li>
+ <li><a href="/versions/{{ current_version }}/user-manual.html">Commands and Options</a></li>
+ <li><a href="/versions/{{ current_version }}/be/overview.html">Build Encyclopedia</a></li>
+ <li><a href="/versions/{{ current_version }}/test-encyclopedia.html">Test Encyclopedia</a></li>
+ <li><a href="/versions/{{ current_version }}/command-line-reference.html">Command Line Reference</a></li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#build-files-menu" aria-expanded="false"
- aria-controls="build-files-menu">
- BUILD files<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="build-files-menu">
- <li><a href="/versions/{{ current_version }}/be/functions.html">Functions</a></li>
- <li><a href="/versions/{{ current_version }}/be/common-definitions.html">Common rule definitions</a></li>
- <li><a href="/versions/{{ current_version }}/be/make-variables.html">"Make" variables</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/build-style.html">BUILD style guide</a></li>
- </ul>
- </li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#build-files-menu" aria-expanded="false"
+ aria-controls="build-files-menu">
+ BUILD Files<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="build-files-menu">
+ <li><a href="/versions/{{ current_version }}/be/functions.html">Functions</a></li>
+ <li><a href="/versions/{{ current_version }}/be/common-definitions.html">Common Rule Definitions</a></li>
+ <li><a href="/versions/{{ current_version }}/be/make-variables.html">"Make" Variables</a></li>
+ <li><a href="/versions/{{ current_version }}/skylark/build-style.html">BUILD Style Guide</a></li>
+ </ul>
+ </li>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#bep-menu" aria-expanded="false"
- aria-controls="bep-menu">
- Build Event Protocol<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="bep-menu">
- <li><a href="/versions/{{ current_version }}/build-event-protocol.html">Overview</a></li>
- <li><a href="/versions/{{ current_version }}/bep-examples.html">BEP examples</a></li>
- </ul>
- </li>
- <li><a href="/versions/{{ current_version }}/output_directories.html">Output directory layout</a></li>
- <li><a href="/versions/{{ current_version }}/platforms.html">Platforms</a></li>
- <li><a href="/versions/{{ current_version }}/exec-groups.html">Execution Groups</a></li>
- <li><a href="/versions/{{ current_version }}/toolchains.html">Toolchains</a></li>
-</ul>
-
-<h3>Extending Bazel</h3>
-<ul class="sidebar-nav">
- <li><a href="/versions/{{ current_version }}/skylark/concepts.html">Extension overview</a></li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#starlark-concepts" aria-expanded="false"
- aria-controls="starlark-concepts">
- Concepts<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-concepts">
- <li><a href="/versions/{{ current_version }}/skylark/macros.html">Macros</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/rules.html">Rules</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/depsets.html">Depsets</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/aspects.html">Aspects</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/repository_rules.html">Repository rules</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/config.html">Configurations</a></li>
- <li><a href="/versions/{{ current_version }}/sandboxing.html">Sandboxing</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#starlark-practices" aria-expanded="false"
- aria-controls="starlark-practices">
- Best practices<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="starlark-practices">
- <li><a href="/versions/{{ current_version }}/skylark/bzl-style.html">.bzl style guide</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/testing.html">Testing extensions</a></li>
- <li><a href="https://github.com/bazelbuild/stardoc">Documenting rules with Stardoc</a></li>
- <li><a href="https://github.com/bazelbuild/buildtools/tree/master/buildifier">Linting</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/performance.html">Optimizing performance</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/deploying.html">Deploying rules</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/windows_tips.html">Writing rules on Windows</a></li>
- </ul>
- </li>
-
- <li><a href="https://github.com/bazelbuild/examples/tree/master/rules">Examples</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/lib/skylark-overview.html">Extensions API</a></li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#persistent-workers" aria-expanded="false"
- aria-controls="persistent-workers">
- Persistent workers<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="persistent-workers">
- <li><a href="/versions/{{ current_version }}/persistent-workers.html">Persistent workers</a></li>
- <li><a href="/versions/{{ current_version }}/multiplex-worker.html">Multiplex workers</a></li>
- <li><a href="/versions/{{ current_version }}/creating-workers.html">Creating persistent workers</a></li>
- </ul>
- </li>
-
- <li><a href="/versions/{{ current_version }}/skylark/rules-tutorial.html">Rules tutorial</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/faq.html">FAQ</a></li>
- <li><a href="/versions/{{ current_version }}/skylark/language.html">Starlark language</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#bep-menu" aria-expanded="false"
+ aria-controls="bep-menu">
+ Build Event Protocol<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="bep-menu">
+ <li><a href="/versions/{{ current_version }}/build-event-protocol.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/bep-examples.html">BEP examples</a></li>
+ </ul>
+ </li>
+ <li><a href="/versions/{{ current_version }}/output_directories.html">Output Directory Layout</a></li>
+ <li><a href="/versions/{{ current_version }}/platforms.html">Platforms</a></li>
+ <li><a href="/versions/{{ current_version }}/exec-groups.html">Execution Groups</a></li>
+ <li><a href="/versions/{{ current_version }}/toolchains.html">Toolchains</a></li>
</ul>
diff --git a/site/_includes/getting-started-sidebar/4/sidebar.html b/site/_includes/getting-started-sidebar/4/sidebar.html
new file mode 100644
index 0000000..2134ff5
--- /dev/null
+++ b/site/_includes/getting-started-sidebar/4/sidebar.html
@@ -0,0 +1,69 @@
+<h3>Home</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/bazel-overview.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/bazel-vision.html">Vision</a></li>
+ <li><a href="/versions/{{ current_version }}/getting-started.html">Getting Started</a></li>
+ <li><a href="/versions/{{ current_version }}/glossary.html">Glossary</a></li>
+</ul>
+
+<h3>Installing Bazel</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/install.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/install-redhat.html">Fedora/CentOS</a></li>
+ <li><a href="/versions/{{ current_version }}/install-os-x.html">macOS</a></li>
+ <li><a href="/versions/{{ current_version }}/install-suse.html">openSUSE</a></li>
+ <li><a href="/versions/{{ current_version }}/install-ubuntu.html">Ubuntu</a></li>
+ <li><a href="/versions/{{ current_version }}/install-windows.html">Windows</a></li>
+ <li><a href="/versions/{{ current_version }}/install-compile-source.html">Compiling from Source</a></li>
+ <li><a href="/versions/{{ current_version }}/install-bazelisk.html">Installing with Bazelisk</a></li>
+</ul>
+
+<h3>Setting up your environment</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/completion.html">Command-Line Completion</a></li>
+ <li><a href="/versions/{{ current_version }}/ide.html">Integrating with IDEs</a></li>
+</ul>
+
+<h3>Tutorials</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/tutorial/cpp.html">C++</a></li>
+ <li><a href="/versions/{{ current_version }}/tutorial/java.html">Java</a></li>
+ <li><a href="/versions/{{ current_version }}/tutorial/android-app.html">Android</a></li>
+ <li><a href="/versions/{{ current_version }}/tutorial/ios-app.html">iOS</a></li>
+</ul>
+
+<h3>Understanding</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/build-ref.html">Core Concepts</a></li>
+ <li><a href="/versions/{{ current_version }}/external.html">External Dependencies</a></li>
+ <li><a href="/versions/{{ current_version }}/configurable-attributes.html">Configurable Attributes</a></li>
+ <li><a href="/versions/{{ current_version }}/platforms-intro.html">Platforms and Toolchains</a></li>
+ <li><a href="/versions/{{ current_version }}/visibility.html">Visibility</a></li>
+</ul>
+
+<h3>Releases</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/versioning.html">Release Versioning</a></li>
+ <li><a href="/versions/{{ current_version }}/backward-compatibility.html">Backward Compatibility</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#release-notes-menu" aria-expanded="false"
+ aria-controls="release-notes-menu">
+ Release Notes<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="release-notes-menu">
+
+ <li><a href="https://blog.bazel.build/2020/11/10/bazel-4.0-announce.html">Bazel 4.0</a></li>
+ <li><a href="https://blog.bazel.build/2020/10/20/bazel-3-7.html">Bazel 3.7</a></li>
+ <li><a href="https://blog.bazel.build/2020/10/06/bazel-3-6.html">Bazel 3.6</a></li>
+ <li><a href="https://blog.bazel.build/2020/08/26/bazel-3.5.html">Bazel 3.5</a></li>
+ <li><a href="https://blog.bazel.build/2020/07/13/bazel-3-4.html">Bazel 3.4</a></li>
+ <li><a href="https://blog.bazel.build/2020/06/17/bazel-3-3.html">Bazel 3.3</a></li>
+ <li><a href="https://blog.bazel.build/2020/05/27/bazel-3-2.html">Bazel 3.2</a></li>
+ </ul>
+ </li>
+</ul>
+
+
+
+
diff --git a/site/_includes/getting-started-sidebar/master/sidebar.html b/site/_includes/getting-started-sidebar/master/sidebar.html
new file mode 100644
index 0000000..2134ff5
--- /dev/null
+++ b/site/_includes/getting-started-sidebar/master/sidebar.html
@@ -0,0 +1,69 @@
+<h3>Home</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/bazel-overview.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/bazel-vision.html">Vision</a></li>
+ <li><a href="/versions/{{ current_version }}/getting-started.html">Getting Started</a></li>
+ <li><a href="/versions/{{ current_version }}/glossary.html">Glossary</a></li>
+</ul>
+
+<h3>Installing Bazel</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/install.html">Overview</a></li>
+ <li><a href="/versions/{{ current_version }}/install-redhat.html">Fedora/CentOS</a></li>
+ <li><a href="/versions/{{ current_version }}/install-os-x.html">macOS</a></li>
+ <li><a href="/versions/{{ current_version }}/install-suse.html">openSUSE</a></li>
+ <li><a href="/versions/{{ current_version }}/install-ubuntu.html">Ubuntu</a></li>
+ <li><a href="/versions/{{ current_version }}/install-windows.html">Windows</a></li>
+ <li><a href="/versions/{{ current_version }}/install-compile-source.html">Compiling from Source</a></li>
+ <li><a href="/versions/{{ current_version }}/install-bazelisk.html">Installing with Bazelisk</a></li>
+</ul>
+
+<h3>Setting up your environment</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/completion.html">Command-Line Completion</a></li>
+ <li><a href="/versions/{{ current_version }}/ide.html">Integrating with IDEs</a></li>
+</ul>
+
+<h3>Tutorials</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/tutorial/cpp.html">C++</a></li>
+ <li><a href="/versions/{{ current_version }}/tutorial/java.html">Java</a></li>
+ <li><a href="/versions/{{ current_version }}/tutorial/android-app.html">Android</a></li>
+ <li><a href="/versions/{{ current_version }}/tutorial/ios-app.html">iOS</a></li>
+</ul>
+
+<h3>Understanding</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/build-ref.html">Core Concepts</a></li>
+ <li><a href="/versions/{{ current_version }}/external.html">External Dependencies</a></li>
+ <li><a href="/versions/{{ current_version }}/configurable-attributes.html">Configurable Attributes</a></li>
+ <li><a href="/versions/{{ current_version }}/platforms-intro.html">Platforms and Toolchains</a></li>
+ <li><a href="/versions/{{ current_version }}/visibility.html">Visibility</a></li>
+</ul>
+
+<h3>Releases</h3>
+<ul class="sidebar-nav">
+ <li><a href="/versions/{{ current_version }}/versioning.html">Release Versioning</a></li>
+ <li><a href="/versions/{{ current_version }}/backward-compatibility.html">Backward Compatibility</a></li>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#release-notes-menu" aria-expanded="false"
+ aria-controls="release-notes-menu">
+ Release Notes<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="release-notes-menu">
+
+ <li><a href="https://blog.bazel.build/2020/11/10/bazel-4.0-announce.html">Bazel 4.0</a></li>
+ <li><a href="https://blog.bazel.build/2020/10/20/bazel-3-7.html">Bazel 3.7</a></li>
+ <li><a href="https://blog.bazel.build/2020/10/06/bazel-3-6.html">Bazel 3.6</a></li>
+ <li><a href="https://blog.bazel.build/2020/08/26/bazel-3.5.html">Bazel 3.5</a></li>
+ <li><a href="https://blog.bazel.build/2020/07/13/bazel-3-4.html">Bazel 3.4</a></li>
+ <li><a href="https://blog.bazel.build/2020/06/17/bazel-3-3.html">Bazel 3.3</a></li>
+ <li><a href="https://blog.bazel.build/2020/05/27/bazel-3-2.html">Bazel 3.2</a></li>
+ </ul>
+ </li>
+</ul>
+
+
+
+
diff --git a/site/_includes/header.html b/site/_includes/header.html
index 3b30f46..de82d8f 100644
--- a/site/_includes/header.html
+++ b/site/_includes/header.html
@@ -28,6 +28,9 @@
</form>
<ul class="nav navbar-nav navbar-right">
<li{% if page.nav == "docs" %} class="active"{% endif %}>
+ <a href="{{ site.getting_started_category_url }}">Getting Started</a>
+ </li>
+ <li{% if page.nav == "docs" %} class="active"{% endif %}>
<a href="{{ site.docs_site_url }}">Documentation</a>
</li>
<li{% if page.nav == "contribute" %} class="active"{% endif %}>
diff --git a/site/_layouts/documentation.html b/site/_layouts/documentation.html
index d8ab958..d13e53d 100644
--- a/site/_layouts/documentation.html
+++ b/site/_layouts/documentation.html
@@ -43,10 +43,10 @@
<!-- If the current version has a explicitly versioned sidebar for the major version -->
{% if site.doc_versions contains current_version %}
- {% capture sidebar %}documentation-sidebar/{{major_version}}/sidebar.html{% endcapture %}
+ {% capture sidebar %}{{page.category}}-sidebar/{{major_version}}/sidebar.html{% endcapture %}
{% else %}
<!-- else, use the latest sidebar -->
- {% capture sidebar %}documentation-sidebar/master/sidebar.html{% endcapture %}
+ {% capture sidebar %}{{page.category}}-sidebar/master/sidebar.html{% endcapture %}
{% endif %}
{% include {{ sidebar }} current_version=current_version %}
</nav>
diff --git a/site/docs/backward-compatibility.md b/site/docs/backward-compatibility.md
index 83b791a..240da27 100644
--- a/site/docs/backward-compatibility.md
+++ b/site/docs/backward-compatibility.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Backward compatibility
+category: getting-started
---
# Backward Compatibility
diff --git a/site/docs/bazel-overview.md b/site/docs/bazel-overview.md
index 57360fc..33e3093 100644
--- a/site/docs/bazel-overview.md
+++ b/site/docs/bazel-overview.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Bazel Overview
+category: getting-started
---
# Bazel Overview
diff --git a/site/docs/bazel-vision.md b/site/docs/bazel-vision.md
index e658831..8910edd 100644
--- a/site/docs/bazel-vision.md
+++ b/site/docs/bazel-vision.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Bazel vision
+category: getting-started
---
# Bazel Vision
diff --git a/site/docs/build-ref.html b/site/docs/build-ref.html
index a992d03..98aa3c9 100644
--- a/site/docs/build-ref.html
+++ b/site/docs/build-ref.html
@@ -1,6 +1,7 @@
---
layout: documentation
title: Concepts and terminology
+category: getting-started
---
<h1>Concepts and Terminology</h1>
<p>
diff --git a/site/docs/completion.md b/site/docs/completion.md
index 01b46f5..fe36990 100644
--- a/site/docs/completion.md
+++ b/site/docs/completion.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Command-line completion
+category: getting-started
---
# Command-Line Completion
diff --git a/site/docs/configurable-attributes.md b/site/docs/configurable-attributes.md
index e5116a1..275fbb8a 100644
--- a/site/docs/configurable-attributes.md
+++ b/site/docs/configurable-attributes.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Configurable build attributes
+category: getting-started
---
# Configurable Build Attributes
diff --git a/site/docs/external.md b/site/docs/external.md
index e04e1bc..9b30c1e 100644
--- a/site/docs/external.md
+++ b/site/docs/external.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: External dependencies
+category: getting-started
---
# Working with External Dependencies
diff --git a/site/docs/getting-started.md b/site/docs/getting-started.md
index efd4708..601a536 100644
--- a/site/docs/getting-started.md
+++ b/site/docs/getting-started.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Getting started
+category: getting-started
---
# Getting Started with Bazel
diff --git a/site/docs/ide.md b/site/docs/ide.md
index d9b97a4..da98b23 100644
--- a/site/docs/ide.md
+++ b/site/docs/ide.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: IDE integration
+category: getting-started
---
# Integrating Bazel with IDEs
diff --git a/site/docs/install-bazelisk.md b/site/docs/install-bazelisk.md
index 85801c8..ccfe665 100644
--- a/site/docs/install-bazelisk.md
+++ b/site/docs/install-bazelisk.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel using Bazelisk
+category: getting-started
---
# Installing Bazel using Bazelisk
diff --git a/site/docs/install-compile-source.md b/site/docs/install-compile-source.md
index 5d5d926..2848357 100644
--- a/site/docs/install-compile-source.md
+++ b/site/docs/install-compile-source.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Compiling Bazel from source
+category: getting-started
---
<h1 id="compiling-from-source">Compiling Bazel from Source</h1>
diff --git a/site/docs/install-os-x.md b/site/docs/install-os-x.md
index 0e00488..238e890 100644
--- a/site/docs/install-os-x.md
+++ b/site/docs/install-os-x.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel on macOS
+category: getting-started
---
<h1 id="mac-os-x">Installing Bazel on macOS</h1>
diff --git a/site/docs/install-redhat.md b/site/docs/install-redhat.md
index 921abe9..89fc8ce 100644
--- a/site/docs/install-redhat.md
+++ b/site/docs/install-redhat.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel on Fedora and CentOS
+category: getting-started
---
# Installing Bazel on Fedora and CentOS
diff --git a/site/docs/install-suse.md b/site/docs/install-suse.md
index c144541..40f6103 100644
--- a/site/docs/install-suse.md
+++ b/site/docs/install-suse.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel on openSUSE
+category: getting-started
---
# Installing Bazel on openSUSE Tumbleweed & Leap
diff --git a/site/docs/install-ubuntu.md b/site/docs/install-ubuntu.md
index b5b3a9b..e53eb05 100644
--- a/site/docs/install-ubuntu.md
+++ b/site/docs/install-ubuntu.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel on Ubuntu
+category: getting-started
---
<h1 id="ubuntu">Installing Bazel on Ubuntu</h1>
diff --git a/site/docs/install-windows.md b/site/docs/install-windows.md
index 6dd934b..ed90b75 100644
--- a/site/docs/install-windows.md
+++ b/site/docs/install-windows.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel on Windows
+category: getting-started
---
# Installing Bazel on Windows
diff --git a/site/docs/install.md b/site/docs/install.md
index 5d32937..0b54bfe 100644
--- a/site/docs/install.md
+++ b/site/docs/install.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Installing Bazel
+category: getting-started
---
# Installing Bazel
diff --git a/site/docs/platforms-intro.md b/site/docs/platforms-intro.md
index 925c3de..ee4d976 100644
--- a/site/docs/platforms-intro.md
+++ b/site/docs/platforms-intro.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Building with platforms
+category: getting-started
---
# Building with Platforms
diff --git a/site/docs/tutorial/android-app.md b/site/docs/tutorial/android-app.md
index 4e998c0..db0637f 100644
--- a/site/docs/tutorial/android-app.md
+++ b/site/docs/tutorial/android-app.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Build Tutorial - Android
+category: getting-started
---
# Bazel Tutorial: Build an Android App
diff --git a/site/docs/tutorial/cc-toolchain-config.md b/site/docs/tutorial/cc-toolchain-config.md
index e11d91d..3c0103a 100644
--- a/site/docs/tutorial/cc-toolchain-config.md
+++ b/site/docs/tutorial/cc-toolchain-config.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Configuring C++ toolchains
+category: getting-started
---
# Bazel Tutorial: Configure C++ Toolchains
diff --git a/site/docs/tutorial/cpp.md b/site/docs/tutorial/cpp.md
index ce254d7..9ade206 100644
--- a/site/docs/tutorial/cpp.md
+++ b/site/docs/tutorial/cpp.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Build Tutorial - C++
+category: getting-started
---
# Bazel Tutorial: Build a C++ Project
diff --git a/site/docs/tutorial/ios-app.md b/site/docs/tutorial/ios-app.md
index 74fab6b..cf1ac03 100644
--- a/site/docs/tutorial/ios-app.md
+++ b/site/docs/tutorial/ios-app.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Build Tutorial - iOS
+category: getting-started
---
# Bazel Tutorial: Build an iOS App
diff --git a/site/docs/tutorial/java.md b/site/docs/tutorial/java.md
index de97c46..120c9b9 100644
--- a/site/docs/tutorial/java.md
+++ b/site/docs/tutorial/java.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Build Tutorial - Java
+category: getting-started
---
# Bazel Tutorial: Build a Java Project
diff --git a/site/docs/updating-bazel.md b/site/docs/updating-bazel.md
index 19fc0ce..b3d9955 100644
--- a/site/docs/updating-bazel.md
+++ b/site/docs/updating-bazel.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Updating Bazel
+category: getting-started
---
# Updating Bazel
diff --git a/site/docs/versioning.md b/site/docs/versioning.md
index 63b8f33..6eab991 100644
--- a/site/docs/versioning.md
+++ b/site/docs/versioning.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Release versioning
+category: getting-started
---
# Release Versioning
diff --git a/site/docs/visibility.md b/site/docs/visibility.md
index e6cb247..aed04f7 100644
--- a/site/docs/visibility.md
+++ b/site/docs/visibility.md
@@ -1,6 +1,7 @@
---
layout: documentation
title: Visibility
+category: getting-started
---
# Visibility
