Finish README

For the first repository tutorial.
Merge pull request #2 from cjgsimon/readme-edits

Finish README, fixes issue #1