A jó komment nem írja le az egyértelmű, triviális (obvious) dolgokat. Mint ahogy értékeadáshoz, ciklushoz, netalántán függvényhíváshoz sem írunk önmagában kommentet.
Amit kommentezni kell, mert névben nehéz lenne kifejezni:
- hogyan csinálja a kód, amit csinál
- miért csinálja a kód azt, amit csinál (akár egy hivatkozás a specifikációra, amit megvalósít)
- milyen side effectek vannak (főleg egy getternél)
Ugyanígy ezért vannak patternjeink, közös szótárunk arra, hogy ha valaki szakmabeli azt mondja, hogy Visitor, Observer vagy Proxy, akkor mindenki tudja, mit akar mondani.
Persze nem mindenki, aki programot ír, az szakmabeli. Mint ahogy nem mindenki villanyszerelő, aki be tud szerelni egy fali csatlakozót. Meg nem lesz üzemeltető az, aki össze tud rakni egy asztali gépet.