Add Documentation

[szabo137]

The documentation needs some careful refactoring:

• add more expressive docstrings
• add tutorials explaining the implementation of the interfaces
• group the API references logically