Some minor changes to the documentation
Indentation in comment block.
Merge pull request #7033 from holmboe/general-doc-fixes

Some minor changes to the documentation