Blog post on Windows status and new installation instructions.

--
MOS_MIGRATED_REVID=135474033

2 files changed, 58 insertions, 2 deletions

diff --git a/site/blog/_posts/2016-09-07-bazel-windows.md b/site/blog/_posts/2016-09-07-bazel-windows.md
new file mode 100644
index 0000000000..30b89ba0a0
--- /dev/null
+++ b/site/blog/_posts/2016-09-07-bazel-windows.md
@@ -0,0 +1,31 @@
+---
+layout: posts
+title: Bazel on Windows
+---
+
+We first announced experimental Windows support in 0.3.0. Since then, we've
+implemented support for building, running and testing C++, Java and Python,
+as well as improved performance and stability. Starting with
+Bazel version 0.3.2, we are making prebuilt Bazel Windows binaries available
+as part of our
+[releases](https://github.com/bazelbuild/bazel/releases)
+([installation instructions](/docs/windows.html#using-the-release-binary)).
+
+In addition to bootstrapping Bazel itself, we're also able to build
+significant parts of TensorFlow with Bazel on Windows
+([pull request](https://github.com/tensorflow/tensorflow/pull/4796)).
+Bazel on Windows currently requires [msys2](https://msys2.github.io/) and
+still has a number of issues. Some of the more important ones are:
+
+ * [Workspace of the project needs to be on C: drive](https://github.com/bazelbuild/bazel/issues/1463)
+ * [Runfiles will require additional tweaking](https://github.com/bazelbuild/bazel/issues/1212)
+ * We support [building C++ code with MSVC toolchain](/docs/windows.html#build-c),
+   but it is not yet the default toolchain.
+
+Our GitHub issue tracker has a [full list of known issues](https://github.com/bazelbuild/bazel/issues?q=is%3Aissue+is%3Aopen+label%3A%22category%3A+multi-platform+%3E+windows%22).
+
+Now, we need your help! Please try building your Bazel project on Windows,
+and let us know what works or what doesn't work yet, and what we can do better.
+
+We are looking forward to what you build (on Windows)!
+
diff --git a/site/versions/master/docs/windows.md b/site/versions/master/docs/windows.md
index 6904d8b3c2..ae5bc04976 100644
--- a/site/versions/master/docs/windows.md
+++ b/site/versions/master/docs/windows.md
@@ -3,8 +3,6 @@ layout: documentation
 title: Windows
 ---
 
-Building Bazel on Windows
-=========================
 
 Windows support is highly experimental. 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)
@@ -12,6 +10,33 @@ on github issues.
 
 We currently support only 64 bit Windows 7 or higher and we compile Bazel as a msys2 binary.
 
+Using the release binary
+=========================
+
+Release binaries are available on our [GitHub release page](https://github.com/bazelbuild/bazel/releases).
+
+To run the binary you will need:
+
+*    Java JDK 8 or later
+*    [msys2](https://msys2.github.io/) (need to be installed at
+     ``C:\tools\msys64\``).
+
+Before you run the binary, you will need to set some environment
+variables:
+
+```bash
+export JAVA_HOME="$(ls -d C:/Program\ Files/Java/jdk* | sort | tail -n 1)"
+export BAZEL_SH=c:/tools/msys64/usr/bin/bash.exe
+```
+
+If you run outside of `bash`, ensure that ``msys-2.0.dll`` is in your ``PATH``
+(if you install msys2 to ``c:\tools\msys64``, just add
+``c:\tools\msys64\usr\bin`` to ``PATH``).
+
+
+Building Bazel on Windows
+=========================
+
 To bootstrap Bazel on Windows, you will need:
 
 *    Java JDK 8 or later