Documentation updates

This pull request includes two sets of changes:

* Updates to the README file adding more information and a code example.
* Fixes for some typos and grammar errors in the code comments.