Eure favorisierte Form der Dokumentation

[bernau]

Zitat von Mavarik:

Alle Änderung bleiben im Quellcode...

Bei mir auch.

Zitat von Dejan Vu:

@Mavarik: Hast Du kein VCS? Dein Code wird doch immer unleserlicher. Hättest Du ein VCS, bräuchtest Du deine Bugfixhistorie im Code nicht.

Änderungen im Quellcode sollen sofort in's Auge springen. Bei einem VCS (welches ich mittlerweile verwende ) müsste man erst aktiv die alte Version vergleichen.

Sollte die Kommentare allerdings den Code unleserlich machen, werden diese Kommentare entfernt, oder ich belege die Kommentare auch einem Verfallsdatum. Heist, die Kommentare werden ab dem Datum entfernt bzw. es bleibt dann nur noch ein Kommentareinzeiler mit dem Änderungsdatum, damit ich ich darauf aufmerksam gemacht werde. Dann kann ich in's VCS hinein schauen.