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.