readme details
Merge pull request #1 from ptone/readme-improvements

Thanks.
Merging changes to README.md from gh-pages