Kapitel 4: Kommentare

»Kommentieren Sie schlechten Code nicht – schreiben Sie ihn um.«

– Brian W. Kernighan und P. J. Plaugher

Nichts kann so hilfreich sein wie ein wohlplatzierter Kommentar. Nichts kann ein Modul mehr zumüllen als leichtfertige dogmatische Kommentare. Nichts kann so viel Schaden anrichten wie ein alter überholter Kommentar, der Lügen und Fehlinformationen verbreitet.

Kommentare sind nicht wie Schindlers Liste. Sie sind nicht »das reine Gute«. Tatsächlich sind Kommentare bestenfalls ein erforderliches Übel. Wären unsere Programmiersprachen ausdrucksstark genug oder hätten wir genügend Talent, unsere Absichten in den ...

Get Clean Code - Refactoring, Patterns, Testen und Techniken für sauberen Code now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.