I know it is lame answer but I am very happy with Claude. I think it decide on mkdocs but it probably does not matter much.

My setup: There is bit of instruction in CLAUDE.md, with reference to full documenting.md startegy. If you are in python, consider doctest - documentation that doubles as unittest.

https://walnutgeek.github.io/lythonic/ https://github.com/walnutgeek/lythonic/