updated documentation for clarity.
fixed a small spelling error I noticed while reading through things
Merge pull request #1728 from carldanley/master

Small docs fixes