Finish readme file, fixes #1

Wrote more than necessary.  (pull request comment)