cleaning up some of the English in the README and making the documentation clearer