README.md doc changes + fixes + improvements
Merge pull request #24 from bradp/docs

README.md doc changes + fixes + improvements