Hallo Vivian,
Du hast recht, dass dies alles nicht gar so viel mit Lenkung von Dokumenten im allgemeinen Sinne
hat. Andererseits bringen Dir die schönsten VA nichts, wenn Dir Deine Grundlage fehlt: EDV.
Was bringt Dir ein Backup, wenn keiner weiss, wie er das komplett abgebrannte EDV-Zentrum wieder
aufzubauen hat. Klar, es ist alles möglich, aber in welcher Zeit?
Es gibt unzählige Möglichkeiten, die erst auf den zweiten Blick damit zu tun haben.
Leider machen sich die wenigsten Gedanken darüber.
Wo steht bei Euch, was ein Admin können und tun muss? Wo dokumentiert er?
Software:
SW sollte optimalerweise "top-down" entwickelt werden.
Das heisst erstellen einer Spezifikation, danach Design und erst dann den Code.
Verifiziert wird dann durch Code-Reviews, Modul-Test, Modul-Integration-Tests und Hardware-Software-Integration-Tests.
Danach folgen die Systemtests am Gesamtprodukt.
Um sicher zu gehen, dass auch alles korrekt umgesetzt wurde gibt es Reviews von Spec, Design
und Code. Zusätzlich wird mit Tracebility gearbeitet, die zeigt, ob alle Requirements umge-
setzt worden sind und zusätzlich, ob alle Requirements abgetestet worden sind.
Diesen SW-Entwicklungsablauf wird auch "V-Modell" genannt.
Wir in der Luftfahrt haben SW auf diesem Wege zu erstellen (gem. RTCA DO178B). Je nach Kritikalität
wird dann lediglich der Umfang reduziert.
Die Validation wird durch die Integration erreicht, denn das Produkt sollte ja richtig
funktionieren. Fehler liegen dann entweder bei der Umsetzung oder bei der Spezifikation selbst.
Andere Bereiche betreiben keinen solchen Aufwand.
Hier wird ein Lasten- und Pflichtenheft erstellt und dann losgelegt.
Dokumentation sollte hier auf jeden Fall in Form eines standardisierten Funktions-/Modulkopfes
erfolgen. Dieser muss eine Kurzbeschreibung der Funktion/Moduls, die Übergabeparameter-
Beschreibung, die benutzten globalen Variablen und die Rückgabewerte aufweisen.
Zusätzlich sind die Code-Zeilen mit mehr "Hirnschmalz" zu kommentieren.
Jede Zeile muss nicht sein. Man sollte eben daran denken, dass man den Code in 2-3 Jahren selber
noch verstehen sollte.
Die Zeit, die ich bei der Erstellung des Codes spare, wenn ich nicht dokumentiere, vervielfacht
sich bei den nächsten Modifikationen.
Was auf jeden Fall auch Sinn macht, ist es eine grobe Architektur der SW zu dokumentieren.
Modifikationen werden dadurch schneller, da weniger Einarbeitungszeit nötig sein wird.
Wieder einmal ein paar Gedanken. ;o)
Grüssle
Felde