Update README.md
fix some doc faux pas
Merge pull request #17 from bkardell/master

merge doc changes