Fill out the documentation

[benjaminhwilliams]

Write user guide, some how-tos and finish the docstrings for automatic API documentation.

Release on Readthedocs.

[noemifrisina]

A first rough version of the documentation is now up and running on Readthedocs.