I've poured a lot of time and effort into documenting my C++ TOML library, generally seeking to write the docs as I would wish to find them if I were a new user: https://marzer.github.io/tomlplusplus/

The docs are built using a spin-off of the documentation generator for the magnum graphics engine, which are themselves a really good documentation example: https://magnum.graphics/