cleaning up some of the English in the README and making the documentation clearer
Merge pull request #221 from georgemillo/master

cleaning up some of the English in the README and making the documentati...