Clean up a couple of inconsistencies in docs
Merge pull request #449 from richardmiller/clean-up-doc-incosistencies

Clean up a couple of inconsistencies in docs