Updated README to be consistent with API

Also minor grammar and formatting fixes for readability.