Heute wieder Beispiele für gute, ja ausgezeichnete Quellcode-Kommentare:

Die Angabe eines Autors ermöglicht es, Code(-änderungen) einer Person zuzuordnen – was die Wartbarkeit erhöht:

Hin und wieder probiert man etwas aus, dass dann aber nicht den erhofften Erfolg bringt. Aussagekräftig (aus-)kommentiert erspart man seinem Nachfolger, in dieselbe Falle zu tappen:

Programmierer sind Menschen! Man sollte sie ihre Freude ausdrücken lassen!*
*an der Ausdrucksweise darf aber noch gearbeitet werden.

Kommentare sollten verständlich sein, auch ohne sich (wie der ursprüngliche Autor) 3 Tage in den Code zu denken. Formulierungen abseits von Fachchinesisch helfen dabei:

🙂 Frohe Ostern.