Finish readme
Merge pull request #2 from vessiot/readme-edits

Finish readme, fixes #1