diff --git a/docs/development/build-instructions-osx.md b/docs/development/build-instructions-osx.md
index 985eb33683f7..7b934cd55b2a 100644
--- a/docs/development/build-instructions-osx.md
+++ b/docs/development/build-instructions-osx.md
@@ -4,8 +4,8 @@ Follow the guidelines below for building Electron on macOS.
 
 ## Prerequisites
 
-* macOS >= 10.8
-* [Xcode](https://developer.apple.com/technologies/tools/) >= 7.3.1
+* macOS >= 10.11.6
+* [Xcode](https://developer.apple.com/technologies/tools/) >= 8.2.1
 * [node.js](http://nodejs.org) (external)
 
 If you are using the Python downloaded by Homebrew, you also need to install
@@ -21,18 +21,24 @@ custom Electron build, you may skip this section.
 For certain features (e.g. pinch-zoom) to work properly, you must target the
 macOS 10.10 SDK.
 
-Official Electron builds are built with [Xcode 7.3.1](http://adcdownload.apple.com/Developer_Tools/Xcode_7.3.1/Xcode_7.3.1.dmg), which does not contain
+Official Electron builds are built with [Xcode 8.2.1](http://adcdownload.apple.com/Developer_Tools/Xcode_8.2.1/Xcode_8.2.1.xip), which does not contain
 the 10.10 SDK by default. To obtain it, first download and mount the
 [Xcode 6.4](http://developer.apple.com/devcenter/download.action?path=/Developer_Tools/Xcode_6.4/Xcode_6.4.dmg)
 DMG.
 
 Then, assuming that the Xcode 6.4 DMG has been mounted at `/Volumes/Xcode` and
-that your Xcode 7.3.1 install is at `/Applications/Xcode.app`, run:
+that your Xcode 8.2.1 install is at `/Applications/Xcode.app`, run:
 
 ```bash
-cp -r /Volumes/Xcode/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.9.sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
+cp -r /Volumes/Xcode/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.10.sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
 ```
 
+You will also need to enable Xcode to build against the 10.10 SDK:
+
+- Open `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Info.plist`
+- Set the `MinimumSDKVersion` to `10.10`
+- Save the file
+
 ## Getting the Code
 
 ```bash