Skip to content

Commit 24c7996

Browse files
committed
Added troubleshooting help for xcode
1 parent b8977f1 commit 24c7996

File tree

1 file changed

+31
-15
lines changed

1 file changed

+31
-15
lines changed

README.md

+31-15
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,8 @@ will need to complete work on your local machine. The general process is:
2121
- Complete the required work
2222
- Upload the work you've done to your personal copy of the assignment on GitHub
2323

24-
For this assignment, we'll do a quick walkthrough of these steps so you will know
25-
what to do in future assignments.
24+
For this assignment, we'll do a quick walkthrough of these steps so you will
25+
know what to do in future assignments.
2626

2727
You can follow along with the steps in the videos below, or continue reading to
2828
get a more detailed explanation of the process of working on lessons in Canvas.
@@ -130,10 +130,27 @@ copied SSH link from GitHub. It should look something like this:
130130
$ git clone [email protected]:<your-user-name>/phase-0-completing-assignments.git
131131
```
132132

133-
Press enter, and you should see a flurry of terminal activity. Once the terminal
134-
gives you control to type again, a new folder with the GitHub name of the
135-
assignment will be present. Change directory into this folder to access the
136-
assignment files.
133+
Press enter, and you should see a flurry of terminal activity.
134+
135+
> **Troubleshooting**: If you are a Mac user and you see the following message:
136+
>
137+
> `xcrun: error: invalid active developer path`
138+
>
139+
> You need to install the Xcode Command Line Tools. Run the following command to
140+
> install them:
141+
>
142+
> ```console
143+
> $ xcode-select --install
144+
> ```
145+
>
146+
> And follow the prompts. Then try running the `git clone` command again. See
147+
> [this Stack Overflow post](https://stackoverflow.com/a/52522566) for more
148+
> details. Note that you may need to re-install `xcode-select` any time you
149+
> update your Mac OS version.
150+
151+
Once the terminal gives you control to type again, a new folder with the GitHub
152+
name of the assignment will be present. Change directory into this folder to
153+
access the assignment files.
137154
138155
```console
139156
$ cd phase-0-completing-assignments
@@ -233,8 +250,8 @@ $ git push
233250
```
234251

235252
This command sends the changes you've made to GitHub. If you revisit your
236-
_personal_ copy of the assignment on GitHub, the commit you just created (with the
237-
message 'Done with assignment') will be the most recent commit on the
253+
_personal_ copy of the assignment on GitHub, the commit you just created (with
254+
the message 'Done with assignment') will be the most recent commit on the
238255
assignment.
239256

240257
Each assignment will be slightly different and will include instructions on what
@@ -260,9 +277,8 @@ your GitHub repository.
260277

261278
2. In Canvas, navigate to the assignment you've been working on. In the upper
262279
right corner of the assignment, you should see a **Submit Assignment** (or
263-
**Start Assignment**)
264-
button. You'll be directed to the bottom of the page, where you can provide a
265-
URL as your submission.
280+
**Start Assignment**) button. You'll be directed to the bottom of the page,
281+
where you can provide a URL as your submission.
266282

267283
3. Paste in your repository's GitHub URL and click **Submit**.
268284

@@ -278,9 +294,8 @@ Let's quickly review the process for completing assignments:
278294
button in the upper right corner of the assignment on Canvas.
279295

280296
**2.** Once forked to your personal account, start the **cloning** for your
281-
assignment. Do this by clicking the **Code** button in GitHub, choosing
282-
**SSH**, then clicking the **clipboard** icon to copy the assignment's GitHub
283-
info.
297+
assignment. Do this by clicking the **Code** button in GitHub, choosing **SSH**,
298+
then clicking the **clipboard** icon to copy the assignment's GitHub info.
284299

285300
**3.** Go to your local environment's terminal and navigate to where you'd like
286301
to store your assignment locally.
@@ -302,7 +317,8 @@ $ git add .
302317
$ git commit -m 'Done with assignment'
303318
```
304319

305-
**9.** Push your work to your personal fork on GitHub with the `git push` command
320+
**9.** Push your work to your personal fork on GitHub with the `git push`
321+
command
306322

307323
**10.** Go to your repository in GitHub and copy the URL. Note, this should be
308324
copied from the browser's address bar, and should start with

0 commit comments

Comments
 (0)