diff --git a/README.md b/README.md
index f5287840a..34ebae220 100755
--- a/README.md
+++ b/README.md
@@ -93,11 +93,18 @@ interpreter in `$PATH` for the Python version of the code you're analyzing.
 
 Platform support:
 
-* Pytype is currently developed and tested on Linux, which is the main supported
+* Pytype is currently developed and tested on Linux\*, which is the main supported
   platform.
 * Installation on MacOSX requires OSX 10.7 or higher and Xcode v8 or higher.
 * Windows is currently not supported unless you use [WSL][wsl].
 
+<sub>\*
+Note: On Alpine Linux, installing may fail due to issues with upstream
+dependencies.  See the details of
+<a href="https://github.com/scikit-build/ninja-python-distributions/issues/27">
+this issue</a> for a possible fix.
+</sub>
+
 ## Installing
 
 Pytype can be installed via pip. Note that the installation requires `wheel`
diff --git a/docs/index.md b/docs/index.md
index 1d8e58fb3..54c911deb 100755
--- a/docs/index.md
+++ b/docs/index.md
@@ -91,11 +91,18 @@ interpreter in `$PATH` for the Python version of the code you're analyzing.
 
 Platform support:
 
-* Pytype is currently developed and tested on Linux, which is the main supported
+* Pytype is currently developed and tested on Linux\*, which is the main supported
   platform.
 * Installation on MacOSX requires OSX 10.7 or higher and Xcode v8 or higher.
 * Windows is currently not supported unless you use [WSL][wsl].
 
+<sub>\*
+Note: On Alpine Linux, installing may fail due to issues with upstream
+dependencies.  See the details of
+<a href="https://github.com/scikit-build/ninja-python-distributions/issues/27">
+this issue</a> for a possible fix.
+</sub>
+
 ## Installing
 
 Pytype can be installed via pip. Note that the installation requires `wheel`