Properly document events

[Cheaterman]

Is your feature request related to a problem? Please describe.
The events aren't documented well enough, as @dennorske mentioned in #140:

I however want us to clarify and label the events properly via sphinx, so we will have to follow up on that later.

Describe the solution you'd like
We need to get this done at some point, which will require delving into Sphinx internals a little.

Describe alternatives you've considered
-

Additional context
-