Check and improve docstrings

[jack89roberts]

Look over readthedocs, docstrings etc. and check everything looks ok/improve where needed

[jack89roberts]

DONE: Fixed indentation, improved page structure.

TODO: some missing parameter descriptions, type hints