General procedure for HW assignments

To start on an assignment in this clone, you need to make your own fork and then clone it:

  1. Fork the assignment repository. This creates your own personal copy of the repo on GitHub, so that you can work independently of other students:
    • On the GitHub web page for the assignment, look for the word “Fork” near the upper right of the page.
    • Click the down-pointing triangle next to it.
    • Click “Create a new fork.”

  2. Clone your new fork using the Git tool of your choice (such as GitHub Desktop, SourceTree, GitUp, Fork (Paul’s current favorite, but not free), GitKraken, or the git command line).

    ⚠️ Make sure you fork and clone the repository; do not just download the zip!

    ⚠️ When you clone the repository, pay attention to where you are cloning it on your computer’s file system. (In GitHub Desktop, you can use Repository → Show in Finder (Mac) / Repository → Show in Explorer (Windows) if you aren’t sure where you cloned it. Other Git GUIs have a similar feature.)

Now open the clone in the appropriate text editor / IDE for the assignment. You can and should commit and push your work as you go.

When you are done with the coding portion of the assignment:

  • Go back to the GitHub web page for your fork (not the starter template).
  • Click the Contribute button, which is just above the list of files.
  • Click Open pull request, then click Create pull request. This will create a diff that shows everything you changed.

When you do this, I will send you instructions for comparing your solution to mine and reflecting on the differences.