Finish README

and continue
Merge pull request #2 from jcbacle/readme-edits

Finish README, fixes #1