Documentation: try to make it work nicely

Fix indentation errors here and there. Proper docstrings here and there.