Kommentare, die die Welt nicht braucht – Folge 8

By crusy|Coding, Lustig|Be the first to comment!

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.