Update to Bazel's installation instructions:
- adding doc about Ubuntu 16.04
- removing doc about Ubuntu 14.04
- individual platform instructions now chunked into separate doc topics
--
PiperOrigin-RevId: 150856210
MOS_MIGRATED_REVID=150856210
diff --git a/site/versions/master/docs/install-compile-source.md b/site/versions/master/docs/install-compile-source.md
new file mode 100644
index 0000000..0291fe6
--- /dev/null
+++ b/site/versions/master/docs/install-compile-source.md
@@ -0,0 +1,53 @@
+---
+layout: documentation
+title: Compile Bazel from Source
+---
+
+# <a name="compiling-from-source"></a>Compile Bazel from source
+
+The standard way of compiling a release version of Bazel from source
+is to use a distribution archive. Download `bazel-<VERSION>-dist.zip`
+from
+the [release page](https://github.com/bazelbuild/bazel/releases) for
+the desired version. We recommend to also verify the signature made by our
+[release key](https://bazel.build/bazel-release.pub.gpg) 48457EE0.
+
+Unzip the archive and call `bash ./compile.sh`; this will create a
+bazel binary in `output/bazel`. This binary is self-contained,
+so it can be copied to a directory on the PATH (e.g.,
+`/usr/local/bin`) or used in-place.
+
+##<a name="compiling-from-source-issues"></a>Known issues when compiling from source
+
+**On Windows:**
+
+* version 0.4.4 and below: `compile.sh` may fail right after start with an error
+ like this:
+
+ ```
+ File not found - *.jar
+ no error prone jar
+ ```
+
+ Workaround is to run this (and add it to your `~/.bashrc`):
+
+ ```
+ export PATH="/bin:/usr/bin:$PATH"
+ ```
+
+* version 0.4.3 and below: `compile.sh` may fail fairly early with many Java
+ compilation errors. The errors look similar to:
+
+ ```
+ C:\...\bazel_VR1HFY7x\src\com\google\devtools\build\lib\remote\ExecuteServiceGrpc.java:11: error: package io.grpc.stub does not exist
+ import static io.grpc.stub.ServerCalls.asyncUnaryCall;
+ ^
+ ```
+
+ This is caused by a bug in one of the bootstrap scripts
+ (`scripts/bootstrap/compile.sh`). Manually apply this one-line fix if you want
+ to build Bazel purely from source (without using an existing Bazel binary):
+ [5402993a5e9065984a42eca2132ec56ca3aa456f]( https://github.com/bazelbuild/bazel/commit/5402993a5e9065984a42eca2132ec56ca3aa456f).
+
+* version 0.3.2 and below:
+ [github issue #1919](https://github.com/bazelbuild/bazel/issues/1919)
