Rimantas Liubertas rašė:
>> Tai mitas (kad geras kodas nereikalauja komentarų).
>
> Aš nesakiau, kad visai nereikalauja. Sakiau, kad kuo geresnis
> kodas tuo mažiau jam reikia komentarų.

Apie tai:
http://blog.tabini.ca/2009/04/30/the-myth-of-the-myth-of-self-commenting-code/

> Pagal statistiką vidutinis amerikietis turi vieną krūtį ir
> vieną sėklidę. Dar pagal statistiką žlunga apie 80% IT
> projektų.

Šiuo atveju statistika yra daug arčiau kūno, nes ji atspindi objektyvią 
realybę.

>
>> Jei projektas tęstinis (palaikomas),
>
> Jei projektas tęstinis, tai nenustebčiau, kad komentarai jame labiau
> žalingi, nei naudingi, nes dažnai neturės ryšio su pačiu kodu. T.y.:

Nesutinku. Komentarą bet kada gali pašalinti ar pataisyti, tačiau, kai 
jo nėra, nors reikia (prireikė) ar gali prireikti -- kur kas 
sunkiau/prasčiau; tokiu atveju rezultatas aiškus: komentuosi kodą arba 
kassyk laipiosi ant to pačio grėblio...


>> tai nenustebčiau, jei net pačiame „gryniausiame“ kode aptiktum min.
>> 10+ % komentarų.
>
> O kiek aptiktume naudingų komentarų?

O alternatyva -- jokių komentarų? Tada -- daug, LABAI DAUG...