Aktualisiert (Mittwoch, den 03. Februar 2010 um 21:21 Uhr) Geschrieben von: Johannes Schlimm Samstag, den 23. Januar 2010 um 22:59 Uhr

Wie man Robert C. Martins Buch Clean Code (deutsche Übersetzung hier) entnehmen kann, sollte Quellcode so geschrieben werden, dass möglichst auf Kommentare verzichtet werden kann. Durchaus nachvollziehen kann ich, dass docblocks nicht nur positiv sind. Deren Vielzahl und manchmal auch Umfang lenkt oft von der Substanz ab.

Allerdings bin ich nicht der Meinung, dass es eine gute Idee ist auf Kommentare völlig zu verzichten. Einige der Dinge, die Robert C. Martin über die Quellcode-Kommentierung schreibt, finden meine volle Zustimmung. Insbesondere sind auskommentierte Bereiche, die für Ewigkeiten om Quellcode verbleiben, eine Unsitte. Wofür gibt es schließlich Quellcodeverwaltungen?