Похоже, мы опять говорим о разных вещах

Видимо, нужно вначале определиться с этим.

Но вначале интересен пример хорошей документации, как для вас. Хотел написать идеальной, но всегда чего-то не хватает.

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

Есть один и только один человек и для кода и для документации. Вот для этого варианта есть пример хорошей документации?

Можно еще один проект для теста со средненькой документацией, главное, чтобы везде были исходники вдобавок.

поясни как это относится к генерированию документации для кода

Очень просто - что есть документация? Это описание чего-либо. Чего именно в данном случае неважно.

Тут мы имеем два описания: вариант "автор", вариант "обработанный автор". Теперь я хочу добавить / изменить описание. Для какого варианта мне проще будет это сделать? И какое описание изначально более понятно?

Ну и еще вдогонку, вот вам нужно что то относительно стандартное написать, будете открывать подобный шаблон у ворда и затем содержание видоизменять или всё с нуля начинёте?