Программисты ленятся писать комментарии. Да - они такие плохие. Но документацию хоть какую-то делать надо. Оказывается для самых ленивых существует система автоматической генерации документации Doxygen. Она сама расколупает код, создаст разделы справки с описанием каждого класса, метода, перечисления и.т.п. Кроме того, она даже рисует графы вызова и вызовов функций (но для этого нужно установить dot от Graphviz). Увы, при полном отсутствии комментариев полезность сгенерированной справки невелика, но даже такая справка позволяет проще разобраться в системе, т.к. автоматически генерирует некоторые UML диаграммы.