dieser Ungleichung stimme ich zu - allerdings sehe ich wie Schuer die Kommentare im Quellcode als *Teil* der Dokumentation. Je nach Komplexität des Projekts ist diese Kommentierung vielleicht bei weitem nicht ausreichend, zählt aber zweifelsohne zur Dokumentation dazu.
das stimmt - aber wenn ich von "dokumentation" rede, ist es das beiliegende "heftchen", welches die genaue funktionsweise nochmal zusammenfasst - also ein handbuch oder nachschlagewerk
kommentare im quelltext sind schön und gut, nur wie du sagst - bei komplexen projekten mit 10000 files mit verstreuten scripten, nutzen dir inline-kommentare wenig, wenn du gar keinen plan hast, wo du überhaupt suchen musst ;)