diff --git a/README.md b/README.md
index 3f6ced2cc96ba7e75ea2c47b9839f6710c1ab0a1..647f0570d5c64faa6d6c35c123741d56f6066843 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,7 @@ You need to install Qt as described below instead of using pre-built packages fr
 * Android: [Qt Android Setup](http://doc.qt.io/qt-5/androidgs.html)
 
 ###### Building using Qt Creator
+
 * Launch Qt Creator and open the `qgroundcontrol.pro` project.
 * Select the appropriate kit for your needs:
     * OSX: Desktop Qt 5.5.1 clang 64 bit
@@ -60,6 +61,18 @@ You need to install Qt as described below instead of using pre-built packages fr
     * Android: Android for armeabi-v7a (GCC 4.9, Qt 5.5.1)
 * Note: iOS builds must be built using xCode: http://doc.qt.io/qt-5/ios-support.html. Use Qt Creator to generate the XCode project (*Run Qmake* from the context menu).
 
+###### Special case for Xcode 8 and Qt 5.5.1
+
+Xcode 8 broke the Qt 5.5.1 build system (qmake). As this is the version of Qt we're using for the moment, you will need to patch your Qt installation to make the build work. This is for both Mac OS X and iOS.
+
+Under the tools directory, you will find a script used by the CI build to patch Qt (`patch_qt_for_xcode8.sh`). You can use this script as a starting point. You will need to edit a few variables it expects to run:
+
+```
+IOSDIR=/<your_qt_path>/Qt/5.5/ios
+OSXDIR=/<your_qt_path>/Qt/5.5/clang_64
+TRAVIS_BUILD_DIR=/<your_github_repo>/qgroundcontrol
+```
+
 #### Vagrant
 
 A Vagrantfile is provided to build QGroundControl using the [Vagrant](https://www.vagrantup.com/) system. This will produce a native Linux build which can be run in the Vagrant Virtual Machine or on the host machine if it is compatible.