For me the best are hand-written tutorial-like docs using material for mkdocs, kept in the same repo, with mkdoxy plugin for drop in doxygen for public interface as reference and mermaid uml for design overview. Just doxygen is often useless without story around. Plus examples dir as starting point