Modernize documentation #6
Description
Classically, documentation has fallen behind the actual implementation. To try to unify code and docs, write documentation as code comments and write a few scripts for generating the markdown from the code comments.
Tie this into the build system and github actions.