How to Submit Homework - SEIR-59/course-wiki GitHub Wiki

Deliverable Submission Guide

You will receive deliverable assignments 2-3 times a week at about 4:50pm PT -- please have them submitted for grading by 9:00am PT the next Monday!

It's a good idea to set a limit for how long you work on the homework and hungry for more assignments: generally speaking, you want to dedicate about four to five hours each night (set a cutoff of midnight - 1am PT). You want to be properly rested for the next day's learning.

1. Get your homework

To access your homework, you will pull the files from Github. Fork and clone down the repo for that evenings homework.

git clone [forked repo name]

Check out a dev branch

git checkout -b dev

2. Complete your homework

Work on your homework in the cloned repo on your desktop for that particular day.

  • Some homework will come with starter code and you can start coding directly in the provided files inside the repo according to the instructions.

  • If homework does not come with starter code, you will need to create the necessary folders and files inside the repo.

  • At certain intervals in your homework markdown, commit your work to git.

3. Commit your work to your local Git repo

  • To submit your homework after you have followed all the commit prompts
    1. commit it on your local Git repo
    2. push it to your repo on Github

The overall process looks like this: in the root folder of your class repo you will run the following commands:

git add .
git commit -m 'Complete step 1'
git push origin main

But first, let's commit to your local, checking on the status of your files along the way. See the status of your homework files with git status:

git_status_1

The above shows that the homework file has been changed but not staged for commit. To stage the file, type git add .

git_add

Then, type git status again to see that it has been staged:

git_status_2

This shows that the file is staged, but not committed. To commit the changes, type git commit -m 'my commit message'. Make sure your commit messages are short and descriptive of the changes.

commit

Terminal output should look like this after committing:

commit2

4. Push your commits to Github

Now push your commits to Github with git push origin main.

  • Note that you are pushing to origin not upstream. Your forked repo in this case is your origin, and this is where you want to push your homework.

git_push_1

Terminal output will look like this:

git_push_2

  • Now your folders and files should appear in your repo on Github.

5. Submit via Pull Request

Your homework is submitted via a pull request on the original repo.

We want to hear about your wins, struggles, and comments to help us grade assignment and to help address any sources of confusion. If you submit an incomplete assignment but leave us notes about what you struggled with, we are much more likely to mark as complete.

Congrats! Your homework is submitted!