Здравствуйте, Pzz, Вы писали:

Pzz>Посмотри, как это сделано в Golang. Я раньше думал, что вся эта автоматически сгенерированная документация — это чушь полная, и документацию надо отдельно писать руками. Сейчас так не думаю.

Одно не заменяет другое. Автоматически сгенерированная дока — это что-то типа справочника, т.е. лишь часть документации.
Есть же еще вводные статьи, описание концепций, основных сценариев, примеры и т.д.


Pzz>Hint: вся документация по этой ссылке — автоматически сгенерированная.

Это вся документация?
Ни о чём совершенно, двойка сходу.

Сравнить с этой докой:
http://www.boost.org/doc/libs/1_65_1/doc/html/program_options/tutorial.html