...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!