Create the "Android and Bazel" and "Apple apps and Bazel" pages.

PiperOrigin-RevId: 168577347

3 files changed, 133 insertions, 3 deletions

diff --git a/site/_layouts/documentation.html b/site/_layouts/documentation.html
index 527edaf8dc..e51baa8f7d 100644
--- a/site/_layouts/documentation.html
+++ b/site/_layouts/documentation.html
@@ -52,7 +52,6 @@ nav: docs
                 <ul class="collapse sidebar-nav sidebar-submenu" id="tutorial-menu">
                   <li><a href="/versions/{{ site.version }}/tutorial/java.html">Build a Java Project</a></li>
                   <li><a href="/versions/{{ site.version }}/tutorial/cpp.html">Build a C++ Project</a></li>
-                  <li><a href="/versions/{{ site.version }}/tutorial/cpp-use-cases.html">Common C++ Use Cases</a></li>
                   <li><a href="/versions/{{ site.version }}/tutorial/android-app.html">Build an Android App</a></li>
                   <li><a href="/versions/{{ site.version }}/tutorial/ios-app.html">Build an iOS App</a></li>
                 </ul>
@@ -66,17 +65,51 @@ nav: docs
 
               <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++ and Bazel</a></li>
+                  <li><a href="/versions/{{ site.version }}/cpp-use-cases.html">Common 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 and Bazel <span class="caret"></span>
+                  Java<span class="caret"></span>
                 </a>
                 <ul class="collapse sidebar-nav sidebar-submenu" id="java-menu">
-                  <li><a href="/versions/{{ site.version }}/tutorial/java.html">Tutorial: Build a Java Project</a></li>
+                  <li><a href="/versions/{{ site.version }}/bazel-and-java.html">Java and Bazel</a></li>
                   <li><a href="/versions/{{ site.version }}/migrate-maven.html">Migrating from Maven to Bazel</a></li>
                   <li><a href="/versions/{{ site.version }}/generate-workspace.html">Generate External Dependencies from Maven</a></li>
                 </ul>
               </li>
 
+              <li>
+                <a class="sidebar-nav-heading" data-toggle="collapse"
+                    href="#android-menu" aria-expanded="false"
+                    aria-controls="android-menu">
+                  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 and Bazel</a></li>
+                </ul>
+              </li>
+
+               <li>
+                <a class="sidebar-nav-heading" data-toggle="collapse"
+                    href="#apple-menu" aria-expanded="false"
+                    aria-controls="apple-menu">
+                  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 apps and Bazel</a></li>
+                </ul>
+              </li>
+
               <li><a href="/versions/{{ site.version }}/test-encyclopedia.html">Writing Tests</a></li>
               <li><a href="/versions/{{ site.version }}/query.html">Query Language</a></li>
               <li><a href="/versions/{{ site.version }}/query-how-to.html">Query How-To</a></li>
diff --git a/site/docs/bazel-and-android.md b/site/docs/bazel-and-android.md
new file mode 100644
index 0000000000..dccb55ac8c
--- /dev/null
+++ b/site/docs/bazel-and-android.md
@@ -0,0 +1,46 @@
+---
+layout: documentation
+title: Android and Bazel
+---
+
+# Android and Bazel
+
+This page contains resources that help you use Bazel with Android projects. It
+links to a tutorial, build rules, and other information specific to building
+Android projects with Bazel.
+
+## Contents
+
+- [Working with Bazel](#working-with-bazel)
+- [Android and Skylark](#android-and-skylark)
+
+## Working with Bazel
+
+The following resources will help you work with Bazel on Android projects:
+
+*  [Tutorial: Building an Android app](tutorial/android-app.html)
+*  [Android rules](https://docs.bazel.build/versions/master/be/android.html)
+*  [mobile-install for Android](mobile-install.html)
+*  [Integration with Android Studio](ide.html)
+
+## Android and Skylark
+
+**Note**: Extending Bazel with Skylark is for advanced build and test scenarios.
+You do not need to use Skylark when getting started with Bazel.
+
+The following [Skylark](https://docs.bazel.build/versions/master/skylark/concepts.html)
+modules, configuration fragments, and providers will help you extend Bazel's
+capabilities when building your Android projects:
+
+*  Modules:
+
+   *  [`android_common`](skylark/lib/AndroidSkylarkApiProvider.html)
+   *  [`AndroidSkylarkIdlInfo`](skylark/lib/AndroidSkylarkIdlInfo.html)
+
+*  Configuration fragments:
+
+   *  [`android`](skylark/lib/android.html)
+
+*  Providers:
+
+   *  [`android`](skylark/lib/AndroidSkylarkApiProvider.html)
diff --git a/site/docs/bazel-and-apple.md b/site/docs/bazel-and-apple.md
new file mode 100644
index 0000000000..35e8af8894
--- /dev/null
+++ b/site/docs/bazel-and-apple.md
@@ -0,0 +1,51 @@
+---
+layout: documentation
+title: Apple apps and Bazel
+---
+
+# Apple apps and Bazel
+
+This page contains resources that help you use Bazel to build macOS and iOS
+projects. It links to a tutorial, build rules, and other information specific to
+using Bazel to build and test for those platforms.
+
+## Contents
+
+- [Working with Bazel](#working-with-bazel)
+- [Apple apps and Skylark](#apple-apps-and-skylark)
+
+## Working with Bazel
+
+The following resources will help you work with Bazel on macOS and iOS projects:
+
+*  [Tutorial: Building an iOS app](tutorial/ios-app.html)
+*  [Objective-C build rules](https://docs.bazel.build/versions/master/be/objective-c.html)
+*  [General Apple rules](https://github.com/bazelbuild/rules_apple)
+*  [Integration with Xcode](ide.html)
+
+## Apple apps and Skylark
+
+**Note**: Extending Bazel with Skylark is for advanced build and test scenarios.
+You do not need to use Skylark when getting started with Bazel.
+
+The following [Skylark](https://docs.bazel.build/versions/master/skylark/concepts.html)
+modules, configuration fragments, and providers will help you extend Bazel's
+capabilities when building your macOS and iOS projects:
+
+*  Modules:
+
+   *  [`apple_bitcode_mode`](skylark/lib/apple_bitcode_mode.html)
+   *  [`apple_common`](skylark/lib/apple_common.html)
+   *  [`apple_platform`](skylark/lib/apple_platform.html)
+   *  [`apple_platform_type`](skylark/lib/apple_platform_type.html)
+   *  [`apple_toolchain`](skylark/lib/apple_toolchain.html)
+   *  [`XcodeVersionConfig`](skylark/lib/XcodeVersionConfig.html)
+
+*  Configuration fragments:
+
+   *  [`apple`](skylark/lib/apple.html)
+
+*  Providers:
+
+   *  [`ObjcProvider`](skylark/lib/ObjcProvider.html)
+   *  [`XcTestAppProvider`](skylark/lib/XcTestAppProvider.html)