docs,windows: update bootstrap & install docs

Update the documentation about:
- compiling Bazel from source (without an existing Bazel binary) on Windows
- OS and software requirements on Windows

Closes #4741.

PiperOrigin-RevId: 187829532

1 files changed, 12 insertions, 10 deletions

diff --git a/site/docs/install-windows.md b/site/docs/install-windows.md
index 857e2a4b2c..428ad08f5d 100644
--- a/site/docs/install-windows.md
+++ b/site/docs/install-windows.md
@@ -7,13 +7,14 @@ title: Installing Bazel on Windows
 
 Supported Windows platforms:
 
-*   64 bit Windows 7 or higher
+*   64 bit Windows 7 or higher, or equivalent Windows Server versions.
 
-Before installing Bazel, make sure your system meets the
-[Windows requirements](windows.html#requirements) to run Bazel.
+Check
+<a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms724832(v=vs.85).aspx">Microsoft's
+Operating System Version table</a> to see if your OS is supported.
 
-After installing Bazel on Windows, see
-[Using Bazel on Windows](windows.html#using).
+Before installing Bazel, make sure your system meets the system and software
+requirements. See the page about [using Bazel on Windows](windows.html).
 
 Install Bazel on Windows using one of the following methods:
 
@@ -24,9 +25,11 @@ Install Bazel on Windows using one of the following methods:
 ## Download the binary (recommended)
 
 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.
+and download the Windows binary.
+
+For convenience, move the binary to a directory that's on your `%PATH%`. This
+way you can run Bazel by typing `bazel` in any directory, without typing out the
+full path. That said, you may put the binary anywhere on your filesystem.
 
 After you download the binary, you'll need additional
 software and some setup in your environment to run Bazel. For details, see the
@@ -34,7 +37,6 @@ software and some setup in your environment to run Bazel. For details, see the
 
 ## Install using Chocolatey
 
-
 You can install the Bazel package using the [Chocolatey](https://chocolatey.org)
 package manager:
 
@@ -43,7 +45,7 @@ choco install bazel
 ```
 
 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++
+its dependencies, such as the MSYS2 shell. This will not install Visual C++
 though.
 
 See [Chocolatey installation and package maintenance