Skip to content

Latest commit

 

History

History

submitting-assignments-using-github-desktop

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 

Submitting Assignments Using GitHub Desktop

Burden: ~30 minutes

Follow every step of these instructions carefully and avoid submitting your assignment in haste or with distractions around you, as these will no doubt hinder your ability to submit successfully.

Note: Before proceeding, make sure you’re using the latest stable release of GitHub Desktop. As of this writing, version 223, Hasty Things Done Hastily, is the latest. Do not use the beta version. If you need to download GitHub Desktop, go here and scroll all the way to the bottom of the page for the latest stable version.

Note: Replace assignment-1 with the name of the assignment repo to which you need to submit your work.

  1. Log in to GitHub and visit the assignment’s repository, or repo, page. For this example, I’ll use a dummy, or slug, repo called assignment-1, https://github.com/code-warrior/assignment-1. ![](img/Screenshot 2017-07-16 10.25.00.png)
  2. Fork the assignment-1 repo by clicking the word fork in the upper right hand corner. ![](img/Screenshot 2017-07-16 10.25.00 2.png)
  3. You’ll see something aking to the following. ![](img/Screenshot 2017-07-16 10.36.13.png)
  4. Once the fork is done, you’ll be taken to the fork’s page in your account. Note the URL and the info in the top left corner to verify that you now have a fork of your own: ![](img/Screenshot 2017-07-16 10.36.21.png)
  5. Now copy, or clone, the repo to your computer by (1) clicking the green Clone or download button, then (2) clicking Open in Desktop, which will launch the GitHub Desktop client. ![](img/Screenshot 2017-07-16 10.43.47.png) ![](img/Screenshot 2017-07-16 10.46.33.png)
  6. In the GitHub Desktop client, leave the entry for Clone As: alone, then choose where you want to save the fork. (I’m saving in a folder called GitHub.) Click Clone in the lower right corner. ![](img/Screenshot 2017-07-16 10.49.24.png)
  7. Every student in any assignment repository has their own branch, formatted as FIRSTNAME-LASTNAME--GITHUB-USERNAME. Click master in the GitHub Desktop client, at the top, along the left, then choose your branch. ![](img/Screenshot 2017-07-16 11.10.39.png) ![](img/Screenshot 2017-07-16 11.12.07.png)
  8. Along the left column, under GitHub, you should see your cloned repository. Context click it and choose Open in Finder or Open in Explorer if you’re using Windows. ![](img/Screenshot 2017-07-16 11.25.49.png)
  9. Do all your work in this folder, committing and syncing often. ![](img/Screenshot 2017-07-16 11.38.51.png) ![](img/Screenshot 2017-07-16 11.46.05.png)
  10. Return to the GitHub Desktop client. Your changes should appear as uncommitted changes next to History. In the screenshot below, for example, I added IMG_0456.jpg and made a change to index.html. Both are considered 2 Uncommitted Changes. ![](img/Screenshot 2017-07-16 11.47.14 3.png) ![](img/Screenshot 2017-07-16 11.47.14 2.png)
  11. Commit your changes by (1) creating a commit message, (2) clicking the Commit to BRANCH_NAME button, and (3) clicking Sync. For example, I’m committing the addition of a picture of a llama. ![](img/Screenshot 2017-07-16 11.52.58.png)
  12. Click History along the top. You should see your commit message along the left. ![](img/Screenshot 2017-07-16 12.00.26.png)
  13. Click Pull Request, then click the left light blue box, then choose the target repo and branch. For example, I need to choose code-warrior/roy-vanegas--roy-vanegas as the target. ![](img/Screenshot 2017-07-16 12.15.40.png) ![](img/Screenshot 2017-07-16 12.16.08.png) ![](img/Screenshot 2017-07-16 12.16.08 2.png)
  14. Expand the GitHub Desktop box so you can read and verify the to and from repos. ![](img/Screenshot 2017-07-16 12.16.58.png)
  15. Add a descriptive message, then click Pull Request. ![](img/Screenshot 2017-07-16 12.19.05.png)
  16. You’ll get a confirmation that your pull request was successfully submitted. Also, in the confirmation will be a link to view the pull request at GitHub’s web site. ![](img/Screenshot 2017-07-16 12.19.10 2.png)