Styling and consistency of documentation could be improved

[orionarcher]

This is split off from PR #78 to address two points the consistency and formatting of the documentation.

Todos:

• [ ] closely read over all documentation for errors
• [ ] make sure all syntax and code styling is consistent
• [ ] enhance aesthetic styling of documentation