Update Installing on Windows instructions so that they match the structure of Ubuntu instructions.
@@ -5,30 +5,38 @@ title: Installing Bazel on Windows
# <a name="windows"></a>Install Bazel on Windows
-Bazel runs on 64 bit Windows 7 or higher.
+Supported Windows platforms:
-Known issues are [marked with label
-"Windows"](https://github.com/bazelbuild/bazel/issues?q=is%3Aissue+is%3Aopen+label%3A%22category%3A+multi-platform+%3E+windows%22)
-on GitHub issues.
+* 64 bit Windows 7 or higher
-To run Bazel on Windows, make sure your system meets the
-[requirements](windows.html#requirements).
+Before installing Bazel, make sure your system meets the
+[Windows requirements](windows.html#requirements) to run Bazel.
-You can get Bazel for Windows using one of the following methods:
+After installing Bazel on Windows, see
+[Using Bazel on Windows](windows.html#using).
-* Download the binary distribution (recommended).
+Install Bazel on Windows using one of the following methods:
- We provide binary versions on our [GitHub releases
- page](https://github.com/bazelbuild/bazel/releases).
+* [Download the binary (recommended)](#download-the-binary-recommended)
+* [Install using Chocolatey](#install-using-chocolatey)
+* [Compile Bazel from source](install-compile-source.html)
- The installer contains only the Bazel binary. You'll need additional
- software (e.g. msys2 shell) and some setup in your environment to run Bazel.
- You can find these on the [Windows requirements page](windows.html).
+## Download the binary (recommended)
-* Use Chocolatey.
+Go to Bazel's [GitHub releases page](https://github.com/bazelbuild/bazel/releases)
+and download the Windows binary. We recommend putting the binary in a directory
+that's on your `%PATH%`. You can, however, put the binary anywhere on your
+filesystem.
- You can install the Bazel package using the
- [Chocolatey](https://chocolatey.org) package manager:
+After you download the binary, you'll need additional
+software and some setup in your environment to run Bazel. For details, see the
+[Windows requirements](windows.html).
+
+## Install using Chocolatey
+
+
+You can install the Bazel package using the [Chocolatey](https://chocolatey.org)
+package manager:
```sh
choco install bazel
@@ -41,7 +49,3 @@ You can get Bazel for Windows using one of the following methods:
See [Chocolatey installation and package maintenance
guide](https://bazel.build/windows-chocolatey-maintenance.html) for more
information about the Chocolatey package.
-
-* [Compile Bazel from source](install-compile-source.html).
-
-## Next: see [Using Bazel on Windows](windows.html#using)
