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

...on clearer

Didn't do the entire README.