autodoc for the Python API

[hadware]

Maybe add some guide to the API for people that want to us it directly in Python.

This shouldn't take much time, as all classes are already properly docstring'd, it's just a matter of using the right autodoc directives in the Sphinx doc.