Die Meinungen zur Dokumentation in Softwareprojekten können weit auseinandergehen. Während sich der eine Entwickler über mangelnde Dokumentation und schlechte Auffindbarkeit der benötigten Informationen beschwert, lässt sich gleichzeitig ein anderer Entwickler darüber aus, wie viel „Waste“ in Form von Dokumenten erzeugt wird und wie sehr dies von der eigentlichen Arbeit abhält.

Beide Sichtweisen sind sicherlich jedem schon einmal begegnet. Sie scheinen beide prinzipiell richtig und durchaus nachvollziehbar zu sein. Und genau das wirft die Frage auf: Wie findet man das richtige Maß an Dokumentation?

Der Stand der Praxis

In der Regel beginnt ein Projekt zunächst mit einer Anforderungsanalyse. Hierzu gibt es einige Literatur, die zwar Kriterien für die Erhebung nennt (z.B. Vollständigkeit oder Konsistenz), jedoch auslässt wie diese erreicht werden können. In der daraus ...

Eine Aufgabe des Projektmanagements, die sicher jeden schon einmal zur Verzweiflung gebracht haben wird, ist eine möglichst passgenaue Aufwandsschätzung für Software abzugeben.

Ich möchte hier einen neuen Ansatz vorstellen. Er ist nicht nur wesentlich einfacher und kommt schneller ...

Code zu kommentieren ist unbeliebt - so scheint es zumindest. Man könnte annehmen, das Dokumentieren an sich, sei eine unangenehme Arbeit. Es liegt jedoch viel mehr daran, dass meist gar nicht klar ist, was eigentlich erwähnenswert ist. Dem schreibenden Programmierer ist meist alles klar. Also ...