- Fork the repository for the assignment, which should appear at
github.com/YOU/REPOSITORY
. - Click the "Clone in Desktop" button on the right sidebar from your fork, not the original. (If you get a "permission denied" error later, you probably skipped this step.)
- Open the
index.html
file in a browser and open the Developer Tools. - Modify the files, and add any files/libraries/assets you need.
- Make small commits as you go.
- Refresh the
index.html
page to see the results, and repeat. - Explain your project in the README:
- How it evolved (with photos is a plus)
- Links/images/video of any inspiration or resources that were helpful
- Feel free to put the above information in a blog post, and simply link from the README instead.
- Make sure all of your changes are committed.
- "Sync" your commits from the GitHub app.
- Create a pull request on the original repository.
- You can continue to push fixes and improvements while the pull request is Open – just add a comment in the pull request to let me know it's been updated.
Your solution will be live at http://USERNAME.github.io/REPOSITORY
. Make sure this version works, since it's what will be looked at to give feedback. Note that after your initial push/sync, it may take up to ten minutes for the site to appear.
When the pull request is created, you should see a message saying that "the Travis CI build is in progress" – this means that your solution is being automatically checked for syntax errors. If this "build" ends up failing (which will show a red "X"), click through the "details" link and scroll to the bottom to see what the errors were. This automated feedback will help you write better code. If it's green checkmark, you're good to go.
I will leave feedback in the pull request, so please respond with your thoughts and questions! You are welcome to open the pull request as a work-in-progress if you are stuck and want to ask a question – just mention @afeld
to make sure I get the notification.