some style updates to the documentation
Description
Some updates to the documentation. Mainly making the capitalization more consistent. This addresses some issues of #636.
News snippet
Some updates to the documentation.
Checklist
-
I have checked that my code follows the Octopus coding standards -
I have added tests for all the new features added in this request.