Documentation improvements

Clearing some outstanding documentation improvements. A subsequent commit will come on the gh-pages branch once this pull lands.