>>Техническая это использовать Доксиген или еще чтото для документирования, а требование комментить код под угрозой непринятия кода это административное средство.
> ну дык и я о чём?
> Важно не путать проблемы со средствами.
> хорошо документированный код - это техническая проблема. Хотя её "техничность" проявляется
> только со временем.

Хорошо документированный код это вообще не проблема.
Плохое документирование техническая проблема, только если ваши технические средства (ИДЕ, редактор и тп) не дают вам комментить ясно и понятно, но это абсурд, нет таких редакторов, которые бы не давали вам писать коммент больше одной строки.
Так что хреновое комментирование и документирование это административная проблема.

> Решается как правило административно.

Естественно, проблема административная и решается административно.
Техническая проблема решаемая административно это бросание персонала "грудью на амбразуру" под угрозой премирования :)

> Был даже опытЪ в одной конторе - требование на 4-5 строчек кода
> должна быть 1 строчка комментария. Во народ изгалялся! :D

Ну дык должен же быть какой то контроль, прием кода наконец. Иначе эти все методы будут чистой фикцией.