Readme updates

- Reformat method docs
- Add password grant_type example
- Spelling/grammar fixes