Dokumentationskonzept
Dokumentationskonzept für die Applikation Massnahmendashboard
Für die interne PostFinance-Applikation Massnahmendashboard wurde ein Dokumentationskonzept erarbeitet, das die strukturierte Ablage und nachhaltige Pflege der Dokumentation regelt.
Ausgangslage und Problemstellung
Das Massnahmendashboard (MNDB) ist eine interne Applikation von PostFinance, die im Bereich Risikomanagement eingesetzt wird und die Umsetzung regulatorischer Anforderungen unterstützt. Die bestehende Dokumentation der Applikation war unvollständig, veraltet und uneinheitlich aufgebaut. Die Informationen waren über unterschiedliche Werkzeuge verteilt und entsprachen nicht mehr dem aktuellen Stand der Applikation, was die Nachvollziehbarkeit und den Wissenstransfer erschwerte. Aus diesem Grund wurde ein Dokumentationskonzept entwickelt, das eine einheitliche Grundlage für die fachliche und technische Dokumentation von MNDB schafft und festlegt, wie diese erarbeitet werden soll.
Der Weg zum Dokumentationskonzept
Als Grundlage wurden zunächst die Applikation MNDB selbst, die relevanten Stakeholder, die bestehenden Dokumentationswerkzeuge sowie die vorhandenen Unterlagen analysiert. Dabei zeigte sich, dass bereits Informationen vorhanden waren, diese jedoch aktualisiert, neu strukturiert und miteinander verknüpft werden müssen. Ein weiterer Schwerpunkt lag darauf, wie die Dokumentation in Zukunft zuverlässig gepflegt werden kann. Dazu wurden zwei Varianten untersucht: eine quartalsweise und eine laufende Aktualisierung der Dokumentation. Mithilfe einer Präferenzmatrix und einer Nutzwertanalyse wurden die Varianten anhand verschiedener Kriterien bewertet. Die quartalsweise Dokumentationspflege erwies sich dabei als die geeignetere Lösung. Zusätzlich wurde untersucht, inwiefern KI die Erstellung und Pflege technischer Dokumentation unterstützen kann. Dabei zeigte sich insbesondere Potenzial bei der Analyse und Zusammenfassung von Source Code, wobei die Ergebnisse jedoch weiterhin von Fachpersonen überprüft werden müssen. Auf Basis dieser Erkenntnisse wurde anschliessend das Dokumentationskonzept ausgearbeitet.
Aufbau und Inhalt des Dokumentationskonzepts
Das erarbeitete Dokumentationskonzept umfasst insgesamt zwölf Dokumentationselemente, welche die unterschiedlichen Aspekte der Applikation abdecken. Für jedes Dokumentationselement wurden fünf zentrale Aspekte definiert:
- Inhalt: Welche Informationen müssen dokumentiert werden?
- Struktur und Darstellung: Wie sollen die Informationen aufgebaut und dargestellt werden?
- Ablageort: Welches Tool ist der führende Ablageort des Dokumentationselement?
- Verantwortlichkeit: Wer ist für das Dokumentationselement zuständig?
- Pflege und Aktualisierung: Wie und wann wird das Dokumentationselement aktualisiert?
Für die Ablageorte wurden ausschliesslich die bereits bei PostFinance vorhandene Werkzeuge Polarion, Confluence und Gitlab berücksichtigt. Die praktische Anwendbarkeit des Konzepts wurde überprüft, indem das Dokumentationskonzept exemplarisch angewendet wurde. Für zehn der identifizierten Dokumentationselemente wurden Anwendungsbeispiele erstellt.
Ergebnisse und Mehrwert
Als Ergebnis liegt ein vollständiges Dokumentationskonzept für MNDB vor, das als Grundlage für die zukünftige Überarbeitung und Pflege der MNDB-Dokumentation dient. Zusätzlich wurden ein Phasenplan und eine Kosten-Nutzen-Analyse erstellt. Das Konzept wurde durch einen Fachexperten anhand von Kriterien wie Vollständigkeit, Verständlichkeit und Umsetzbarkeit beurteilt. Die Beurtilung fiel positiv aus und bestätigte die Praxistauglichkeit des erarbeiteten Konzepts.
Durch das Dokumentationskonzept wird die Erstellung und Pflege der Dokumentation für MNDB wesentlich vereinfacht, da klare Vorgaben definiert wurden, an welchen man sich orientieren kann. Diese einheitlichen Vorgaben tragen zusätzlich dazu bei, dass das vorhandene Wissen über die Applikation langfristig gesichert und leichter zugänglich gemacht wird. Die strukturierte Dokumentation wird den Wissenstransfer erleichtern, die Wartung und Weiterentwicklung der Applikation unterstützen und die Einarbeitung neuer Mitarbeitender vereinfachen.
Ausblick
Mit dem erarbeiteten Dokumentationskonzept liegt eine praxisnahe Grundlage vor, um die Dokumentation von MNDB aufzubauen und langfristig zu pflegen. Nach der Einführung soll überprüft werden, wie sich die definierten Vorgaben, Ablageorte, Verantwortlichkeiten und Pflegeprozesse im Arbeitsalltag bewähren. Das Dokumentationskonzept soll nicht als unveränderbares Ergebnis betrachtet werden, sondern mit der Weiterentwicklug der Applikation, neuen technischen Möglichkeiten und veränderten internen Vorgaben wachsen und optimiert werden.
















