Getting Started

1. Make sure you have XCode 9 installed on your computer
2. On our DCSCiOS github page, click "Clone or Download", then "Open in Xcode".
3. The project will open in Xcode. Save it somewhere on your computer.

Dealing with Accounts in Xcode

1. There's two account details to need to fill in: Apple Account and Github Account
2. Navigate to Xcode > Preferences > Accounts
3. Select the + button in the botom left corner of the window
4. Select Apple Id. Insert your Apple Id
5. Select + button again. Select Github. Insert Github credentials.

-> At this point, you should be able to run the app in the simulator. If you are having difficulties, let me know. Don't let this annoying account stuff discourage you!

Adding Changes to the App

1. Github allow you to "branch" changes to keep everything organized.
2. Create a new branch in Xcode: a) Navigate to the "Source Control Panel" b) Option+Click Branches > master > branch from "master" c) name your branch with you first and last name

Now any changes you make are only contained in your specific branch. This way, if multiple people are changing things at the same time, things won't brake.

3. Change things to your little's heart's content.

4. When you want to add your changes to Github, select Source Control > Commit

5. Write a commit message briefly describing your changes.

6. Select Source Control > Push. This will upload your branch to Github for all to see.

7. When you would like to add your changes to the master branch, create a Pull Request on Github. I (Andrew) will then merge your changes into the master branch.