WDI-17 (General Assembly, Sydney)
##Homework Repository
- Repository Setup;
- Do Your Homework;
- Submit Your Homework.
You only need to do this once, not every time you're submitting homework!
- Fork this repository
- 'Forking' creates a personal, 'forked' copy of this repository on your Github account.
- Hit the Fork button in the top right-hand corner of this page.
- Clone your forked repository to your computer
- 'Cloning' takes your 'forked' repository on GitHub and creates a local copy - or 'clone' - on your computer.
- Make sure you're browser is open to your forked version of this repository on Github (eg http://github.com/{{YOUR_USERNAME}}/wdi17-homework).
- Hit the Clone or Download button in the top right-hand corner of the page and copy the URL to your clipboard.
- Open your computer's terminal to the directory in which you intend to store your homework.
git clone url_of_your_fork_on_github
(whereurl_of_your_fork_on_github
is the URL you copied after hitting 'Clone or Download', above).
- Add an upstream remote repository
- Adding an upstream repository links the local repository on your computer to the original repository on Github (i.e. mine, the one from which you created the fork)
cd wdi17-homework
git remote add upstream https://github.com/textchimp/wdi17-homework
git pull upstream master
You should put each night's homework in a new folder within the appropriate directory of your homework repo. So, for day two, where you have two tasks ("Calculator" and "Strings"), you might do something like this:
- Open Terminal/iTerm2;
- Go to your local homework repo (eg,
cd Projects/general-assembly/wdi17-homework
); - From here, go to the folder matching your name within that repo, and the appropriate week (eg,
groucho_marx/week_01
); - Create new folders for each of the day's homework tasks: (eg
mkdir calculator
andmkdir strings
); - Create the files necessary to complete the homework in their respective directories;
- Get to it!
You need to do this every time you're submitting homework.
- Commit your work to your local repository progressively
- Make sure you are the correct folder containing the homework you want to submit.
git add .
git commit -m "YOUR_COMMIT_MESSAGE_GOES_HERE"
(whereYOUR_COMMIT_MESSAGE_GOES_HERE
is your description of the work you are committing)
- Push your changes to your forked repository
git pull upstream master
- merge changes that have been made to this repository into your own local repository.git push origin master
- Once you're finished, submit a pull request for me to accept your homework
- Navigate to your forked version of this repository on Github (eg https://github.com/{{YOUR_USERNAME_HERE}}/wdi17-homework).
- Hit the Pull request button.
- Make sure the destination for the pull request is set to my repository, not your own or anyone else's.
- IMPORTANT: In the pull request comment, tell me the following:
- How difficult did you find this (out of 10)? 0 being no problems at all, 10 being impossible;
- Was there anything that you struggled with?;
- Is there anything that you'd like some further information on?;
- Roughly how long did it take?
If you don't mention anything in the Pull Request comments, we will assume you had no problems at all with it!
Note: if I haven't yet merged your Pull Request into my master homework repo before it's time to submit the next day's homework, you won't be able to create a new Pull Request. That's okay - for the new homework just add a new comment to the open (existing) Pull Request, featuring the same four points given above to describe your response to it.