Doc: put rules in a separate section
Also, make more obvious that Bazel can be used with other languages (not just the few native rules).
RELNOTES: None.
PiperOrigin-RevId: 214929370
diff --git a/site/_layouts/documentation.html b/site/_layouts/documentation.html
index f8c8fc7..4fd3231 100644
--- a/site/_layouts/documentation.html
+++ b/site/_layouts/documentation.html
@@ -68,49 +68,24 @@
</li>
<li><a href="/versions/{{ site.version }}/user-manual.html">User Manual</a></li>
+ <li><a href="/versions/{{ site.version }}/windows.html">Using Bazel on Windows</a></li>
+ <li><a href="/versions/{{ site.version }}/external.html">Adding External Dependencies</a></li>
+ <li><a href="/versions/{{ site.version }}/query-how-to.html">Querying Builds</a></li>
+ <li><a href="/versions/{{ site.version }}/test-encyclopedia.html">Writing Tests</a></li>
+ <li><a href="/versions/{{ site.version }}/configurable-attributes.html">Configurable Attributes</a></li>
+ <li><a href="/versions/{{ site.version }}/best-practices.html">Best Practices</a></li>
+ <li><a href="/versions/{{ site.version }}/remote-caching.html">Remote Caching</a></li>
+ </ul>
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#cpp-menu" aria-expanded="false"
- aria-controls="cpp-menu">
- Bazel and C++<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="cpp-menu">
- <li><a href="/versions/{{ site.version }}/bazel-and-cpp.html">C++ Resources</a></li>
- <li><a href="/versions/{{ site.version }}/cpp-use-cases.html">C++ Use Cases</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#java-menu" aria-expanded="false"
- aria-controls="java-menu">
- Bazel and Java<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="java-menu">
- <li><a href="/versions/{{ site.version }}/bazel-and-java.html">Java Resources</a></li>
- <li><a href="/versions/{{ site.version }}/migrate-maven.html">Migrating from Maven</a></li>
- <li><a href="/versions/{{ site.version }}/generate-workspace.html">Converting Maven Dependencies</a></li>
- </ul>
- </li>
-
- <li>
- <a class="sidebar-nav-heading" data-toggle="collapse"
- href="#javascript-menu" aria-expanded="false"
- aria-controls="javascript-menu">
- Bazel and JavaScript<span class="caret"></span>
- </a>
- <ul class="collapse sidebar-nav sidebar-submenu" id="javascript-menu">
- <li><a href="/versions/{{ site.version }}/bazel-and-javascript.html">JavaScript Resources</a></li>
- <li><a href="/versions/{{ site.version }}/build-javascript.html">Building JavaScript</a></li>
- </ul>
- </li>
+ <h3>Rules</h3>
+ <ul class="sidebar-nav">
+ <li><a href="/versions/{{ site.version }}/be/overview.html">Build Encyclopedia</a></li>
<li>
<a class="sidebar-nav-heading" data-toggle="collapse"
href="#android-menu" aria-expanded="false"
aria-controls="android-menu">
- Bazel and Android<span class="caret"></span>
+ Android<span class="caret"></span>
</a>
<ul class="collapse sidebar-nav sidebar-submenu" id="android-menu">
<li><a href="/versions/{{ site.version }}/bazel-and-android.html">Android Resources</a></li>
@@ -125,7 +100,7 @@
<a class="sidebar-nav-heading" data-toggle="collapse"
href="#apple-menu" aria-expanded="false"
aria-controls="apple-menu">
- Bazel and Apple<span class="caret"></span>
+ Apple<span class="caret"></span>
</a>
<ul class="collapse sidebar-nav sidebar-submenu" id="apple-menu">
<li><a href="/versions/{{ site.version }}/bazel-and-apple.html">Apple Resources</a></li>
@@ -133,19 +108,49 @@
<li><a href="/versions/{{ site.version }}/migrate-cocoapods.html">Converting CocoaPods</a></li>
</ul>
</li>
- <li><a href="/versions/{{ site.version }}/windows.html">Using Bazel on Windows</a></li>
- <li><a href="/versions/{{ site.version }}/external.html">Adding External Dependencies</a></li>
- <li><a href="/versions/{{ site.version }}/query-how-to.html">Querying Builds</a></li>
- <li><a href="/versions/{{ site.version }}/test-encyclopedia.html">Writing Tests</a></li>
- <li><a href="/versions/{{ site.version }}/configurable-attributes.html">Configurable Attributes</a></li>
- <li><a href="/versions/{{ site.version }}/best-practices.html">Best Practices</a></li>
- <li><a href="/versions/{{ site.version }}/remote-caching.html">Remote Caching</a></li>
- </ul>
- <h3>Reference</h3>
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#cpp-menu" aria-expanded="false"
+ aria-controls="cpp-menu">
+ C++<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="cpp-menu">
+ <li><a href="/versions/{{ site.version }}/bazel-and-cpp.html">C++ Resources</a></li>
+ <li><a href="/versions/{{ site.version }}/cpp-use-cases.html">C++ Use Cases</a></li>
+ </ul>
+ </li>
+
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#java-menu" aria-expanded="false"
+ aria-controls="java-menu">
+ Java<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="java-menu">
+ <li><a href="/versions/{{ site.version }}/bazel-and-java.html">Java Resources</a></li>
+ <li><a href="/versions/{{ site.version }}/migrate-maven.html">Migrating from Maven</a></li>
+ <li><a href="/versions/{{ site.version }}/generate-workspace.html">Converting Maven Dependencies</a></li>
+ </ul>
+ </li>
+
+ <li>
+ <a class="sidebar-nav-heading" data-toggle="collapse"
+ href="#javascript-menu" aria-expanded="false"
+ aria-controls="javascript-menu">
+ JavaScript<span class="caret"></span>
+ </a>
+ <ul class="collapse sidebar-nav sidebar-submenu" id="javascript-menu">
+ <li><a href="/versions/{{ site.version }}/bazel-and-javascript.html">JavaScript Resources</a></li>
+ <li><a href="/versions/{{ site.version }}/build-javascript.html">Building JavaScript</a></li>
+ </ul>
+ </li>
+
+ </ul>
+
+ <h3>Reference</h3>
<ul class="sidebar-nav">
<li><a href="/versions/{{ site.version }}/build-ref.html">Bazel Concepts</a></li>
- <li><a href="/versions/{{ site.version }}/be/overview.html">Build Encyclopedia</a></li>
<li><a href="/versions/{{ site.version }}/skylark/build-style.html">BUILD Style Guide</a></li>
<li><a href="/versions/{{ site.version }}/command-line-reference.html">Command Line Reference</a></li>
<li><a href="/versions/{{ site.version }}/build-event-protocol.html">Build Event Protocol</a></li>
diff --git a/site/docs/bazel-overview.md b/site/docs/bazel-overview.md
index a6f74d9..f3ee947 100644
--- a/site/docs/bazel-overview.md
+++ b/site/docs/bazel-overview.md
@@ -36,8 +36,10 @@
source files. It works with multiple repositories and user bases in the tens
of thousands.
-* **Bazel is extensible.** You can extend Bazel to support your language of
- choice.
+* **Bazel is extensible.** Many
+ [languages](https://docs.bazel.build/versions/master/be/overview.html#rules)
+ are supported, and you can extend Bazel to support any other language or
+ framework.
# How do I use Bazel?
@@ -53,8 +55,9 @@
3. **Write a `BUILD` file**, which tells Bazel what to build and how to
build it.
- You write your `BUILD` file by declaring build targets using an abstract
- Python-like language. (See example [here](https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD).)
+ You write your `BUILD` file by declaring build targets using
+ [Starlark](https://docs.bazel.build/versions/master/skylark/language.html),
+ a domain-specific language. (See example [here](https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD).)
A build target specifies a set of input artifacts that Bazel will build plus
their dependencies, the build rule Bazel will use to build it, and options
diff --git a/site/docs/getting-started.md b/site/docs/getting-started.md
index d7dc809..5a73f1e 100644
--- a/site/docs/getting-started.md
+++ b/site/docs/getting-started.md
@@ -31,6 +31,8 @@
* [Tutorial: Build an iOS Application](tutorial/ios-app.html)
+Once you are familiar with the basics, you can try the rules for
+[other languages](be/overview.html).
## Migration
