Add developer documentation

[lukethehuman]

Ensure the codebase is covered with developer documentation:

• Docstrings on all files, classes, methods, functions. Suggest numpy format.
• Comments where appropriate.
• Consider contribution guides / templates.