Decide on whether to stay with mkdocs or use something else

mkdocs development has stalled. The original author has started mkdocs 2.0 which is incompatible with v1. Others have forked and continue working on a v1 compatible version.

Todo: decide what to use