15.11.2016

Collaborative Documentation: Mit just enough zu mehr Nachhaltigkeit

Rückblick zu "10 Things"-Vortrag

Sinnvolle und richtige Dokumentation ist das Grundgerüst von jedem IT-Projekt. Doch wie viel Dokumentation ist notwendig?

Rückblick zur vierten Veranstaltung der Reihe "10 things I wished they'd told me!" im Jahr 2016

Vinzenz Preiss, Experte für Software Test und Requirements Engineering, beendete die Veranstaltungsreihe "10 things I wished they'd told me!" 2016 mit einem spannenden Vortrag zum Thema Collaborative Documentation und begeisterte die Teilnehmer mit 10 praxisnahen Tipps.

Sinnvolle und richtige Dokumentation ist das Grundgerüst von jedem IT-Projekt. Doch wie viel Dokumentation ist notwendig?

Ausgangspunkt für jede Dokumentation sollten Überlegungen zum Nutzen für die Zielgruppe sein. Nur wenn das Dokument das Problem der Zielgruppe erfüllt, wird es auch angenommen.

Machen Sie sich auch Gedanken darüber, in welchem Reifegrad sich Ihr Dokument entlang des Produktlebenszyklus befindet. Entlang dieses Prozesses reift das Produkt und verändert sich, bis es schließlich seinen definierten Zweck erfüllen kann. Unterstützen Sie diesen Prozess durch frühe Stichworte und validieren Sie inhaltliche Eckpunkte. Formulieren Sie aber erst möglichst spät aus. Je später Sie Ihre Beschreibung in seine finale Form bringen, desto geringer ist die Gefahr von unerwünschtem Änderungsaufwand.

Das inhaltlich beste Dokument erfüllt seinen Zweck jedoch nicht, wenn es nicht auch ansprechend gestaltet ist. Auch etwas Niedergeschriebenes führt zu User Experience. Sorgen Sie deshalb für ansprechendes Dokumenten-Design. Wählen Sie eine Darstellung, bei der Infos durch die natürliche Auffassungsgabe des Menschen direkter transportiert werden können.

Doch nicht immer sind geschriebene Dokumente die sinnvollste Lösung. Nichts ist effektiver als das persönliche Gespräch. Info, die nur von kurzer Relevanz ist oder Verständnis, das einmal geschaffen wurde, muss nicht niedergeschrieben werden.