fix typos, update docs, clarify wrong example
Merge pull request #2 from jaustinhughey/master

fix typos, update docs, clarify wrong example