Technische Softwaredokumentation unter ökonomischen Gesichtspunkten – Ein formal-deduktiver Ansatz

Zusammenfassung

Der Softwaredokumentation wird offensichtlich ein nur sehr geringer Stellenwert eingeräumt. So zeichnet sich beispielsweise ca. 80 % der weltweiten Software durch eine unzureichende Dokumentation aus. Dabei bestätigen empirische Studien, dass mit der Verfügbarkeit einer adäquaten technischen Programmdokumentation eine Reduktion der Fehleranfälligkeit von nachträglichen Änderungen im Rahmen der Softwarewartung einhergeht. Für jedes Softwareprojekt ergibt sich demnach die Frage, in welcher Höhe eine Investition in die Erstellung einer technischen Programmdokumentation ökonomisch sinnvoll ist. Dieses Entscheidungsproblem wurde wissenschaftlich bisher stark vernachlässigt. Da entsprechende Zusammenhänge empirisch vermutlich nur schwer aufgedeckt werden können, stellt der Beitrag einen neuartigen deduktiven Ansatz vor, welcher die barwertigen Auszahlungen für die Erstellung einer technischen Programmdokumentation und für die Fehlerbehebung gegenüberstellt. Grundlage des Modells bildet das Phänomen der Fehlerausbreitung von einer Komponente über deren Abhängigkeiten zu angrenzenden Komponenten. Auf dieser Basis kann folgende Hypothese abgeleitet werden: Auch bei einer beliebig niedrigen Dokumentationsqualität oder einem beliebig hohen Kalkulationszinssatz ist es stets vorteilhaft, eher zu viel als vergleichsweise zu wenig zu dokumentieren. Diese Hypothese erweist sich dabei auch gegenüber der Änderung einiger Annahmen als robust.

Abstract

Only a very low priority seems to be given to software documentation. For example, about 80% of the software systems in production worldwide are badly documented. In contrast empirical studies confirm that an adequate technical documentation reduces the error rate of subsequent changes during software maintenance. This leads to the question about the optimal scale of investment in technical documentation in any software project. In research, this decision problem has been largely neglected. Since underlying cause-effect relationships may be empirically hard to detect, this paper proposes a new deductive approach, which compares the present value of payments for the documentation and bug fixing. The basis of this model is the phenomenon of error propagation from one component to adjacent components through its dependencies. As a result the following hypothesis can be inferred: It is always beneficial to document too much rather than comparatively too little even for an arbitrarily low quality of documentation and for any required rate of interest. This hypothesis shows robustness even against some changes in assumptions.