Programmierer und Dokumentation
Es ist ein leidiges Thema, Programmierer und Dokumentation. Es gibt kaum jemanden, der gerne Dokus zu seinem Code schreibt. Häufig höre ich, dass vor allem Open Source Projekte auf diesem Gebiet nicht gerade glänzen.. ich denke, dass diese Sache zeigt, dass Closed Source genauso schlimm, wenn nicht schlimmer ist.
Für diejenigen, die das nicht alles lesen wollen, eine Kurzfassung:
Microsoft wurde von einer EU-Kommission dazu verknurrt, ihre Windows Server Protokolle zu dokumentieren. Microsoft hat daraufhin 12′000 (!) Seiten Doku abgeliefert. Die Kommission hat aber entschieden, dass das nicht genügt, bzw. dass die von Microsoft gelieferte Doku nichts taugt, um die Protokolle zu verstehen. Tja, was macht Microsoft jetzt? Sie stellen einfach den ganze Sourcecode (unter einer speziellen Lizenz natürlich) zur Verfügung und sagen:
The Windows source code is the ultimate documentation of Windows Server technologies. With this step our goal is to resolve all questions about the sufficiency of our technical documentation.
Kann man sichs leichter machen? Tut mir leid, aber das ist doch einfach lächerlich.. nicht?
2 comments on “Programmierer und Dokumentation”
Leave a comment
You must be connected to write a comment.
Typisch! Der Sourcecode nützt rein gar nichts, weil:
a) Nie jemand, der nochmals ein Protokoll in eine Produkt implementieren möchte, diese Lizenz unterschreiben will
b) Niemand Zeit hat den ganzen Source zu lesen
und zu guter Letzt c) dieser Code vermutlich eine Katastrophe ist.
Das sich das ganze selbst mit 12′000 Seiten nicht dokumentieren lässt spricht gegen das Protokoll, gegen die Fähigkeiten von Microsoft (zu programmieren und zu dokumentieren) und/oder dafür das Microsoft ein Interesse hat mit der EU-Kommissions zusamen zuarbeiten.
Hello, my name is Alex, i’m a newbie here. I really do like your resource and really interested in things you discuss here, also would like to enter your community, hope it is possible:-) Cya around, best regards, Alex!