Update macOS Install Instructions

Updating macOS install instructions together with David.

Closes #5025.

PiperOrigin-RevId: 193374002

1 files changed, 42 insertions, 8 deletions

diff --git a/site/docs/install-windows.md b/site/docs/install-windows.md
index 428ad08f5d..c04188f7ff 100644
--- a/site/docs/install-windows.md
+++ b/site/docs/install-windows.md
@@ -9,23 +9,52 @@ Supported Windows platforms:
 
 *   64 bit Windows 7 or higher, or equivalent Windows Server versions.
 
-Check
+_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.
+Operating System Version table</a> to see if your OS is supported._
 
-Before installing Bazel, make sure your system meets the system and software
-requirements. See the page about [using Bazel on Windows](windows.html).
+### 1. Install prerequisites (if not already installed)
 
-Install Bazel on Windows using one of the following methods:
+*   Python 2.7 or later.
+
+    Use the Windows-native Python version. Do not use Python that comes with the
+    MSYS2 shell or that you installed in MSYS using Pacman because it doesn't
+    work with Bazel.
+
+*   [MSYS2 shell](https://msys2.github.io/).
+
+    You also need to set the `BAZEL_SH` environment variable to point to
+    `bash.exe`. For example in the Windows Command Prompt (`cmd.exe`):
+
+    ```
+    set BAZEL_SH=C:\tools\msys64\usr\bin\bash.exe
+    ```
+
+    **Note**: do not use quotes (") around the path like you would on Unixes.
+    Windows doesn't need them and it may confuse Bazel.
+
+*   Several MSYS2 packages.
+
+    Run the following command in the MSYS2 shell to install them:
+
+    ```bash
+    pacman -Syuu git curl zip unzip
+    ```
+
+*   [Microsoft Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145)
+
+    This may already be installed on your system.
+
+### 2. Install Bazel on Windows using one of the following methods:
 
 *   [Download the binary (recommended)](#download-the-binary-recommended)
 *   [Install using Chocolatey](#install-using-chocolatey)
 *   [Compile Bazel from source](install-compile-source.html)
 
-## Download the binary (recommended)
+#### Download the binary (recommended)
 
 Go to Bazel's [GitHub releases page](https://github.com/bazelbuild/bazel/releases)
-and download the Windows binary.
+and download the Windows binary<sup>1</sup>: `bazel-<version>-installer-windows-x86_64.sh`.
 
 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
@@ -35,7 +64,12 @@ 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
+_<sup>1</sup>Note that Bazel includes an embedded JDK 8, which can be used even if
+a JDK is already installed. bazel-<version>-without-jdk-installer-windows-x86_64.sh
+  is a version of the installer without embedded JDK 8. Only use this installer if
+  you already have JDK 8 installed._
+
+#### Install using Chocolatey
 
 You can install the Bazel package using the [Chocolatey](https://chocolatey.org)
 package manager: