Updated README to be consistent with API

Also minor grammar and formatting fixes for readability.
Merge pull request #8 from Pie21/master

Updated README to be consistent with API