Softwaredokumentation

Aus aktuellem Anlass möchte ich doch noch einmal deutlich machen wie wichtig eine vernünftige Dokumentation von SourceCode ist.
Ich sitze gerade vor einem Grafiktreiber, der beim Abspielen von Videos ein segfault produziert und den gesamten X Server neu starten lässt.
Das Kommentar, direkt vor dem Code lässt nicht viel Hilfe bei dem Problem erhoffen:

/* ? */
if(pPriv->grabbedByV4L)
return Success;

Es scheint mir der Entwickler wusste selber nicht was er tat.
Gut das ich absolut 0 Ahnung von der Materie habe und wie schön das ich mich nun extra einarbeiten muss.

Natürlich passiert das aber nicht nur bei Treibercode und natürlich auch nicht nur bei OpenSource. Eine Gute Dokumentation könnte allen Entwicklern so viel Arbeit ersparen, vor allem, da die Anzahl der Personen die den Code verstehen will meist größer ist als die der Personen die ihn geschrieben haben.
Wünscht mir Glück!