Write actual documentation

[JasperSnoek]

We should write some documentation in the readme file indicating how to:

• Install the package
• Run the examples
• Possibly explain somewhat how to create new modules