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!

Guttbye!

Es ist nun doch so weit, Guttenberg ist zurück getreten. In seiner Rede gibt er nun seine Fehler sehr offen zu. Ich habe mich stark zurück genommen und nicht vor diesem Schritt darüber gebloggt, ganz einfach weil Ich nie verstanden habe wieso der Ex-Minister so lange damit gewartet hat.
Ich gehe im folgenden davon aus, dass die Doktorarbeit mit Vorsatz plagiiert wurde, ich denke darüber lässt sich viel streiten, aber eine solche Menge an vergessenen Fußnoten ist nicht tragbar und passiert vor allem nicht versehentlich.

Guttenberg wirkt seit beginn der Affäre, oder mehr seit ihrer Verschärfung absolut nicht vertrauenswürdig. Eine solche Person kann und darf keinesfalls an der politischen Spitze stehen und das Deutsche Volk regieren. Ein Betrüger darf nicht, auch wenn man ihn "Verteidigungsminister [...] keinen Inhaber einer Doktorarbeit" nennt ist er dennoch ein und die selbe Person.
Ich bin der Meinung, dass der heutige Schritt der einzige noch richtige war und ich denke jetzt ist er ein gutes Beispiel für all die Leute, die ihre Arbeiten nicht selber verfassen.

Guttbye!