Besser gar keine Kommentare als falsche oder sinnlose ala
Delphi-Quellcode:
// *******************
// * Prozdur bla *
// *******************
procedure bla;
var
i: integer; // Schleifenvariable
begin
// alle Listenelemente durchlaufen
for i := 0 to Liste.Count -1 do begin
// Listenelement verarbeiten
Process(Liste[i]);
end;
end;
letztere reduzieren die Lesbarkeit ohne irgendwas beizutragen.
Programmierer sollten sich besser auf verständlichen Code (Struktur und Namensgebung) konzentrieren als auf Teufel komm raus Kommentare zu schreiben. Kommentare sollen beschreiben, warum etwas auf eine bestimmte Weise gemacht wird, und das auch nur dann, wenn es nicht offensichtlich ist.