Użytkownik "A.L." napisał w wiadomości grup
dyskusyjnych:tdrbb9leujgvoi2qqu2eq0npvub8l7hirp@4ax.
com...

>Mniej wiecej, komentowanie powinno spelnaic role podobna do
>mechanizmow "programming by contract"

Brak komentarza wynika tylko i wyłącznie z lenistwa. Ludzie zwykli w
najrozmaitszy sposób racjonalizować swoje lenistwo i są w tym naprawdę
dobrzy. Więc będą nawijać coś o samokomentującym się kodzie, będą pisali
oczywiste rzeczy nie wymagają, będą twierdzili, że szkoda czasu na komentarz
(bo niby lepiej poświecić go na klepanie kodu na godzinę przed deadline).
Ale wszystko to ma jedynie zamaskować wrodzone rodzajowi ludzkiemu
nieróbstwo.

Oczywiście będą tacy, którzy wysuną argument, że komentarz nie odpowiadający
temu co jest w kodzie jest szkodliwy. I będą mieli trochę racji. Dokładnie
tyle, żebyśmy wysnuli wniosek, iż cnotą jest utrzymywanie porządku tak w
kodzie, jak i w komentarzach oraz innej dokumentacji.

Moim zdaniem, jeżeli używa się Dobrego Języka Dostatecznie Wysokiego Poziomu
(DJDWP), to na każdą linijkę programu powinny przypadać dwie linijki
komentarza. Lub nawet więcej.

Dlaczego? Bo DJDWP jest tak zwięzłą notacją, że w jednej linijce można
zrobić taki ogrom pracy, iż zasługuje ona na więcej niż jedną linijkę
komentarza.

A ponadto nie jest głupie pisanie komentarza choćby po to, aby zrozumieć
czego się nie rozumie we własnym programie. No chyba że ktoś jest A.L. i
potrafi pisać programy od razu z klawiatury heksadecymalnej... i to
bezbłędnie działające. Mistrz tak doskonały nawet jak milczy, to i tak
komentuje swoim milczeniem dzieło jakie stworzył.