@@ -115,21 +115,24 @@ Until Obelisk offers a `ob deploy` equivalent for mobile apps, you are recommend
115115
116116#### First time setup
117117Development on iOS requires a computer running macOS and an iOS developer account.
118+Your account must also belong to an Apple Developer Team, if you want to access developer portal links (otherwise they'll redirect to your account page).
118119
119120##### iPhone
1201211. Connect the iPhone on which you'd like to run builds - this will open up iTunes.
1211221. Click accept to authorize on both the computer and the iPhone.
122123
123124##### Xcode
124−1. Install Xcode 8.2 (contains iOS SDK 10.2).
125+Install Xcode 8.2 (contains iOS SDK 10.2) and open it so that it runs its post install tool setup.
126+
125127These versions will work out of the box but iOS SDKs prior to 11.3 should also work. You can choose another installed version in `default.nix`
128+
126129More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
127−To add another SDK to your current Xcode, [download](https://developer.apple.com/download/more/) the corresponding Xcode, extract it and copy its SDK folder next to the installed one, e.g.
130+To add another SDK to your current Xcode, [download](https://developer.apple.com/download/more/) the corresponding Xcode, extract it and copy its SDK folder next to the installed one, e.g.
128131```
129132open -W Xcode_9.2.xip
130133sudo cp -R Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS11.2.sdk
131134```
132−1. Open Xcode once so that it runs its post install tool setup.
135+
133136
134137You can verify that you have correct versions by running
135138```
@@ -137,9 +140,8 @@ xcodebuild -showsdks
137140```
138141
139142##### Certificates
140−Now you need to inform Apple of your development devices and permissions by
141−adding credentials to the correct provisioning profile via the Apple Developer
142−portal.
143+To deploy and/or package apps, you'll need to inform Apple of your development devices and permissions by
144+adding credentials to the correct provisioning profile via the Apple Developer portal.
143145
1441461. Open up XCode and go to Preferences - Accounts. Select the organization
145147Member role, click Manage Certificates, and add an iOS Development