Write API docs

[dometto]

We should have clear API docs like this.

[bartkamphorst]

Something like this?

[dometto]

Lol, yes. But we should write some actual inline docs then.

[bartkamphorst]

Reason for closing?

[dometto]

Despair at open issues :)