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.