Writing good documentation is hard. Tools can’t solve this problem in themselves, but they can ease the pain.
This post will show you how to use Sphinx to generate attractive, functional documentation for C++ libraries, supplied with information from Doxygen. We’ll also integrate this process into a CMake build system so that we have a unified workflow.
For an example of a real-world project whose documentation is built like this, see fmtlib.

Excellent article, I used this to document MOTIS utl module - cf. PR 25