Tag: CARDS+

Wieso benötigen wir eindeutige Begriffe?

Ein weiterer sehr wichtiger Aspekt einer guten Dokumentation ist die klare Definition und Verwendung von Begriffen – fachlich und technisch. In einem komplexen Umfeld kommt es sehr oft zu der Situation, in denen wir unterschiedliche Ausdrücke für den gleichen Begriff in der Systembeschreibung verwenden, um damit unterschiedliche Zielgruppen besser zu erreichen. In der technischen Umsetzung müssen…
Read more

Was bedeutet redundanzfreie Ablage?

Es ist schon sehr herausfordernd, alle wesentlichen Informationen über den gesamten Lebenszyklus eines Software-Produktes  zu sammeln, zu aktualisieren und strukturiert zu speichern. Durch Fluktuation oder durch Änderungen in der Organisation des Unternehmens entsteht außerdem ein regelmäßiger Wechsel der Mitarbeiter im Projekt und bei den Stakeholdern. Damit verbunden ist immer die Gefahr des Verlustes von Wissen im…
Read more

Welche Zielgruppen haben wir?

Ich habe mich schon oft gefragt, was wir in unserem agilen Umfeld wirklich dokumentieren wollen und vor allem können. Bei der Frage, was wir dokumentieren, müssen wir Klarheit haben über die Zielgruppen für die Dokumentation. Eine Zielgruppe hat entweder fundamentales Wissen zum Einsatz des Produktes oder benötigt Wissen über das Produkt, um Tätigkeiten im Rahmen des Projektes durchzuführen.

Wir sind agil!

Das Manifest für agile Softwareentwicklung legt in Punkt 2 ganz klar den Fokus auf funktionierende Software. In manchen Projekten wird dieser Wert ganz gern als Argument verwendet, dass in agilen Projekten nichts mehr dokumentiert werden muss. Das ist so nicht haltbar, weil das Manifest jeden Wert als Ganzes schätzt, nur halt die linke Seite höher…
Read more

Wissenswerte

Im Projektalltag führe ich Gespräche mit Kollegen über Themen im Zusammenhang mit agiler Dokumentation, streite mich sogar, um am Ende Kompromisse und Lösungen zu finden. Dabei entstehen immer wieder markante Aussagen, die einen Sachverhalt gut auf den Punkt bringen. Diese wissenswerte Zitate möchte ich unter dem Titel “Wissenswerte” sammeln.

Was ist eine Produktdokumentation?

In einem Software-Projekt passiert eine ganze Menge. Projektmitarbeiter produzieren das Software-Produkt, also Code in einer oder mehreren Programmiersprachen und Konfigurationen für den Betrieb. Abhängig von der Projektorganisation und dem gewählten Vorgehen – phasen-orientiert, iterativ oder agil – schreiben Manager, Analysten und Spezialisten verschiedener technischer Disziplinen im Laufe der Zeit eine ganze Reihe von Dokumenten.