Minor editing of main README

I'm a little bit inspired by your great API docs, and figure the least I can do is offer some pedantic edits in return :)