Styling and consistency of documentation could be improved #79
Description
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