Finish ReadMe

Goal is to merge this branch to master
Merge pull request #2 from perumar/readme-edits

Finish ReadMe, fixes #1