Update Installing on Windows instructions so that they match the structure of Ubuntu instructions.

PiperOrigin-RevId: 171312843

1 files changed, 31 insertions, 27 deletions

diff --git a/site/docs/install-windows.md b/site/docs/install-windows.md
index a9a83e3105..a5019ae6aa 100644
--- a/site/docs/install-windows.md
+++ b/site/docs/install-windows.md
@@ -5,43 +5,47 @@ 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).
 
-    ```sh
-    choco install bazel
-    ```
+## Install using Chocolatey
 
-    This command will install the latest available version of Bazel and most of
-    its dependencies, such as the msys2 shell. This will not install Visual C++
-    though.
 
-    See [Chocolatey installation and package maintenance
-    guide](https://bazel.build/windows-chocolatey-maintenance.html) for more
-    information about the Chocolatey package.
+You can install the Bazel package using the [Chocolatey](https://chocolatey.org)
+package manager:
 
-*   [Compile Bazel from source](install-compile-source.html).
+```sh
+choco install bazel
+```
 
-## Next: see [Using Bazel on Windows](windows.html#using)
+This command will install the latest available version of Bazel and most of
+its dependencies, such as the msys2 shell. This will not install Visual C++
+though.
+
+See [Chocolatey installation and package maintenance
+guide](https://bazel.build/windows-chocolatey-maintenance.html) for more
+information about the Chocolatey package.