Documentation is essential. Without knowing what certain functions/classes/… do, it is very difficult to use any code properly.
Tools can help to provide a documentation. They can extract information from the source code and combine it with manually written information to generate documentation in a human readable output format.
There is a problem though: The current tools for C++ documentation aren’t that great. This post explains why and provides a (work-in-progress) solution.» read more »