We should look at setting up the building process for the developer documentation. We do have docstrings on all public APIs, just building something automatically from them would be a good start.
Suggested solution:
- set up doxygen / sphinx for automatic documentation generation