Update documentation to address #3063
RELNOTES: None
PiperOrigin-RevId: 157393208
diff --git a/site/blog/_posts/2017-05-26-Bazel-0-5-0-release.md b/site/blog/_posts/2017-05-26-Bazel-0-5-0-release.md
index 8b01088..b84a0c4 100644
--- a/site/blog/_posts/2017-05-26-Bazel-0-5-0-release.md
+++ b/site/blog/_posts/2017-05-26-Bazel-0-5-0-release.md
@@ -11,6 +11,14 @@
is not available. It solidifies the Build Event Protocol and [Remote Execution
APIs](https://docs.google.com/document/d/1AaGk7fOPByEvpAbqeXIyE8HX_A3_axxNnvroblTZ_6s/edit).
+**Known issue on MacOS**
+
+Bazel release 0.5.0 contains a bug in the compiler detection on macOS which
+requires Xcode and the iOS tooling to be installed
+([corresponding issue #3063](https://github.com/bazelbuild/bazel/issues/3063)).
+If you had Command Line Tools installed, you also need to switch to Xcode using
+`sudo xcode-select -s /Applications/Xcode.app/Contents/Developer`.
+
## Improvements from our roadmap
### Bundled JDK
diff --git a/site/versions/master/docs/install-os-x.md b/site/versions/master/docs/install-os-x.md
index a41a00f..a369d7d 100644
--- a/site/versions/master/docs/install-os-x.md
+++ b/site/versions/master/docs/install-os-x.md
@@ -5,6 +5,14 @@
# <a name="mac-os-x"></a>Install Bazel on macOS (OS X)
+**Known issue on MacOS**
+
+Bazel release 0.5.0 contains a bug in the compiler detection on macOS which
+requires Xcode and the iOS tooling to be installed
+([corresponding issue #3063](https://github.com/bazelbuild/bazel/issues/3063)).
+If you had Command Line Tools installed, you also need to switch to Xcode using
+`sudo xcode-select -s /Applications/Xcode.app/Contents/Developer`.
+
Install Bazel on macOS (OS X) using one of the following methods:
* [Use Homebrew](#install-on-mac-os-x-homebrew)
