diff --git a/docs/en/appium-setup/real-devices.md b/docs/en/appium-setup/real-devices.md
index 2569978d4..1758596d0 100644
--- a/docs/en/appium-setup/real-devices.md
+++ b/docs/en/appium-setup/real-devices.md
@@ -21,6 +21,22 @@ can find information about this in the [Apple documentation](https://developer.a
 Appium will attempt to install your app using Fruitstrap, but it is often easier
 to pre-install your app using Xcode to ensure there are no problems (see the [iOS deploy](ios-deploy.md) doc for more information).
 
+### Testing using Xcode 8 (including iOS 10) with XCUITest
+
+This functionality currently depends on logging based on `idevicesyslog`, and
+port forwarding based on `iProxy`, both of which are part of `libimobiledevice`.
+Install it with [Homebrew](http://brew.sh/),
+
+```
+brew install libimobiledevice
+```
+
+Alternatively, logging can be done using `deviceconsole`, which is available
+[here](https://github.com/rpetrich/deviceconsole). To choose between them, use
+the desired capability `realDeviceLogger`, passing in the path to the logging
+program.
+
+
 ### Running your tests with Appium
 
 Once your device and app are configured, you can run tests on that device by
diff --git a/docs/en/appium-setup/running-on-osx.md b/docs/en/appium-setup/running-on-osx.md
index 8314dbdca..f26a79916 100644
--- a/docs/en/appium-setup/running-on-osx.md
+++ b/docs/en/appium-setup/running-on-osx.md
@@ -61,6 +61,19 @@ If you're using multiple Xcode versions, you can switch between them using:
 
     sudo xcode-select --switch <path to required xcode>
 
+### Testing using Xcode 8 (including iOS 10) with XCUITest
+
+In order to automate iOS devices with Xcode 8 (which includes all testing of iOS 10+),
+you need to install the [Carthage](https://github.com/Carthage/Carthage) dependency
+manager:
+
+```
+brew install carthage
+```
+
+
+
+
 ### System setup (Android)
 
 Instructions for setting up Android and running tests on Mac OS X are the same as
@@ -76,7 +89,7 @@ First download the jenkins-cli.jar and verify the Mac successfully connects to J
 java -jar jenkins-cli.jar \
  -s https://team-appium.ci.cloudbees.com \
  -i ~/.ssh/id_rsa \
- on-premise-executor \ 
+ on-premise-executor \
  -fsroot ~/jenkins \
  -labels osx \
  -name mac_appium
@@ -85,7 +98,7 @@ java -jar jenkins-cli.jar \
 Next define a LaunchAgent for Jenkins to launch automatically on login. A LaunchDaemon will not work because daemons don't have GUI access. Make sure the plist doesn't contain the `SessionCreate` or `User` key as that may prevent tests from running. You'll see a `Failed to authorize rights` error if misconfigured.
 
 ```
-$ sudo nano /Library/LaunchAgents/com.jenkins.ci.plist 
+$ sudo nano /Library/LaunchAgents/com.jenkins.ci.plist
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -126,7 +139,7 @@ Finally set the owner, permissions, and then start the agent.
 ```
 sudo chown root:wheel /Library/LaunchAgents/com.jenkins.ci.plist
 sudo chmod 644 /Library/LaunchAgents/com.jenkins.ci.plist
- 
+
 launchctl load /Library/LaunchAgents/com.jenkins.ci.plist
 launchctl start com.jenkins.ci
 ```