Abstand v. Dokumenation u. Code

...je größer, desto gefährlicher! (d. h. interne Dokumentation ist noch relativ sicher)

wenn möglich, externe Dokumente daraus durch Werkzeuge generieren.

warum nur unsicher: der Compiler kann zwar den Code prüfen und ausführen, aber nicht die Kommentare.

Ideal: schreibe selbst-dokumentierenden Code!



Johannes Waldmann 2007-06-13