Modernize documentation

[andnp]

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.