self-documented код — зло?

[exchange12rocks]

 

Comments

[tat-ti.livejournal.com]

Это как в джаве? Когда пишу функцию, так сразу ее документирую в том же файле?
Тогда это добро.
Правда, иногда с кулаками.

Альтернатива где?

[paracloud.livejournal.com]

Две девочки, добрая и злая, кидались с балкона помидорами в прохожих.
Добрая попала 7 раз, а злая только 3.
Так добро в очередной раз победило зло.

Код, который понятен хотя бы самому разработчику через полгода, уже self-documented.