Und was genau soll man bei selbsterklärendem Code kommentieren?
Meiner Erfahrung nach gibt es den nicht
Aus der genannten Seite:
Zitat:
Perhaps that's the dirty little secret of code comments: to write good comments you have to be a good writer.
Was meine ich mit "gibt es nicht" - je nach Level der anderen mitarbeitenden (zukünftigen) Entwickler - sowohl generell, als auch Sprach- bzw. Projekt-spezifisch, gibt es in komplexen Systemen nichts, wo nicht ein wenig Dokumentation angebracht ist. Sei es eine Beschreibung des Typen, der Methodenparameter, auftretender Exceptions, oder - innerhalb der Methode - die Logik. Letzteres ist das, was oft am wenigsten nötig ist, aber Schnittstellen und Methoden sollten meiner Erfahrung nach immer eine Beschreibung mit sich bringen.
...
...
Daniel W.
Ich bin nicht zurück, ich tue nur so