Merge pull request #607 from alex/docs-nits

A few style nits in the docs