[Bits&Bytes] - Der Teufelskreis der Dokumentation
In der Forschung wie der meinigen gibt es den sogenannten "Teufelskreis der Dokumentation".
Wenn das Dokumentieren von Quellcodes nicht von Seiten der Führungsetage vorgeschrieben ist (und das ist es an Forschungseinrichtungen recht selten), dann tritt für gewöhnlich dieser Teufelskreis in Aktion:
Denn man würde als Entwickler schon gerne dokumentieren, aber nur, wenn es auch eine kritische Masse an Leuten gibt (meist >1), die die Dokumentation auch nutzt. Ansonsten macht man es sehr halbherzig und an vielleicht einem Nachmittag im Jahr mal für ein paar Klassen.
Eventuelle Nutzer einer Dokumentation nutzen diese aber nur, wenn sie auch signifikanten Inhalt erwarten können, und nicht nur 2% der Klassen dokumentiert sind. Also nutzen sie sie nicht.
Und da sie nicht genutzt werden, schreibt sie auch keiner - sondern widmet sich lieber der Entwicklung neuer Klassen und Module, die einen persönlich weiter voranbringen. |