Potpuno očiglednom tvrdnjom da kod sam po sebi treba da bude jasan pokušavate braniti neobranjivo - da komentari nisu ni potrebni.
Evo samo nekoliko primjera kada su meni komentari veoma korisni za upoznavanje sa nepoznatim kodom:
-Kada je originalni koder odlučio da umjesto očiglednog rešenja upotrebi na očigled komplikovanije (zbog performansi - koje nisu očigledne, jer se pokazalo da očigledno izleće iz nekih drugih ograničenja programa - npr. memorije, ili se sukobljava sa nekim drugim djelom aplikacije, zbog ispravka bug-a) - da bi spriječio onog ko pregleda kod da promjeni
- Kada se poziva nešto što je u drugoj klasi, radi bog zna šta, zavisi od druge klase ili nešto slično - a jednostavno se može objasniti - da bi se olakšalo programeru da prati taj dio koda bez skakanja sa klase na klasu(ovdje su meni odlični i oni /** komentari u javi koje IDEi sami čitaju)
- kada se koristi neki specifičan način da se nešto uradi - jer je tako definisano negdje u dokumentaciji - da ne bi programer morao za svaku glupost da se referencira na dokumentaciju
Istina je da loši komentari mogu da zbune - ali i loš kod itekako može da zbuni - izazivam vas da svojim logičkim aparatom izađete na kraj sa
ovim kodom (mada su u ovom slučaju kod pisali dobri programeri)
Naravno da bi između odličnog koda bez komentara i lošeg koda sa komentarima izabrao ovo prvo - ali to nije nikakav argument da se dobar kod ne može učiniti još boljim dobrim komentarima. Uostalom - pogledajte velike projekte i nadjite neki koji ne nekomentarisan?