some small documentation updates
merge in master
Merge pull request #1 from cabbott/feature/doc_updates

Feature/doc updates