documentation improvements
Merge pull request #2250 from greg0ire/doc_improvements

Doc improvements