Add documentation

[ctiedt]

This issue consists of two sub-issues:

1. Add consistent comments and doc-comments
2. Add external documentation, e.g. in the README explaining the general project architecture