no bug; cosmetic adjustments for readability
Merge pull request #2351 from phrawzty/minor_docs_cleanup

no bug; cosmetic adjustments for readability