I spoke with Jeff and David, who encouraged me to start this topic.
I am the author of mp-units and I get plenty of great feedback for our practices. mp-units docs are built with Material for MkDocs and can be found at mp-units.
I would like to point out a few specific sections:
- Look and Feel - mp-units - Compiler Explorer links to examples (some problems with keeping them up to date)
- C++ compiler support (API/ABI) - mp-units with up-to-date compilation status
- Installation and Usage - mp-units - Modern CMake + Conan with modules and
import std;usage, - Contributing - mp-units - symbolic link to CONTRIBUTING.md in the project’s root directory,
- FAQ - mp-units
- Tags Index - mp-units the most interesting examples categorized with tags,
- Glossary - mp-units with the list of the official terms we use consistently in our documentation
- Blog - mp-units with release announcements (we have amazing feedback for this) and ISO standardization progress
- Release Notes - mp-units - symbolic link to CHANGELOG.md in the project’s root directory
- API Reference - mp-units - an experimental API Reference in standardeese.
The last part was added only recently. It is built from LaTex files in the repo. I would prefer Markdown, but we did not know how to do it.
The documentation generation instructions can be found at Contributing - mp-units.
I hope that you like it and will find it useful.