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