API documentation

[tdixon97]

We have a farily good amount of docstrings to generate API docs / doxygen. But some files are totally missing this, for example almost all the event generator code.
I think this is an important thing to add for v1

[gipert]

yes, this and many others are also all good tasks for AI. I would prioritize implementing #641.