Von A bis Z.
Ein Wiki ist einfach zu bedienen. Autoren verwenden vordefinierte Bausteine in einer festen Struktur. Interessierte Parteien, Produktverantwortliche und die gesamte Projektorganisation unterstützen sich gegenseitig. Sie lernen voneinander. Laufend. Sie finden eine gemeinsame Sprache. Sie können sich jederzeit im Wiki über das Produkt informieren, wie es jetzt ist. Sie geben Feedback. Kontinuierlich. Sie nutzen das Feedback zur Verbesserung der Software. Ganz einfach.
Architekturentwurf
In den Bausteinen für den Architekturentwurf werden die vom Auftraggeber geforderten Qualitätsmerkmale, fundamentale Entscheidungen und übergreifende Konzepte nachvollziehbar erfasst. Ein ganz wichtiges Ziel ist die Darstellung und Kommunikation des Architekturstils.
Asciidoc
«Asciidoc» ist eine beliebte textbasierte Auszeichnungssprache. Eine Asciidoc-Datei kann durch eine geeignete Konvertierung als Spezifikation im Wiki veröffentlicht werden.
Autor
Produktverantwortliche, Analysten, IT- und UX-Experten, Redakteure und Vertreter des Realisierungsteams sind Autoren. Interessierte Parteien unterstützen sie als Co-Autoren. Ein Autor ist berechtigt, neue Seiten im Wiki anzulegen und bestehende Seiten zu ändern oder zu löschen. Seine Aufgabe ist es, Seiten im Wiki inkrementell mit Produktwissen zu füllen.
Case
Der Baustein Case gibt einem Anwendungsfall, einer besonderen Situation oder einem bekannten und akzeptierten Fehler einen eindeutigen Namen und enthält eine fachliche Beschreibung und — sobald die Fähigkeit realisiert wurde — die Essenzschritte der gewählten Lösung.
COC
«Convention over configuration» hat das Ziel, die Komplexität von Konfigurationen zu reduzieren.
COD
«Convention over documentation» hat das Ziel, Dokumentation durch Konventionen zu vermeiden oder zu reduzieren.
Decision
Der Baustein Decision wird verwendet, um konsequent alle fundamentalen technischen Entscheidungen oder vom Auftraggeber geforderten Qualitätsmerkmale, deren Rücknahme bzw. Veränderung große Auswirkung auf das Produkt haben, zu dokumentieren.
DOD
Eine «Definition of done» verkörpert ein explizites und geteiltes Verständnis davon, unter welchen Bedingungen ein Produkt fertig ist.
Domain
DRY
«Don´t repeat yourself» hat zum Ziel, jede unnötige Wiederholungen von Inhalten im Wiki zu vermeiden.
Entity
Epic
Der Baustein Epic gibt einer produktspezifischen Funktionalität einen eindeutigen Namen und enthält eine fachliche Beschreibung. Er bündelt eine mit den Anforderungen wachsende Menge von fachlich verwandten Fähigkeiten, besonderen Situationen und bekannten akzeptierten Fehlern, die im Detail mit dem Baustein Case dokumentiert werden.
Event
Medienbibliothek
Gärtner
Gärtner sind Experten für Dokumentation und Administrator für das Wiki. Sie sind verantwortlich für die Auswahl der Werkzeuge für die Erstellung der Dokumentation. Als Trainer für cards+ ist er für Autoren und Leser greifbar und hilft ihnen bei der Bewältigung von alltäglichen wie auch speziellen Problemen im Zusammenhang mit Dokumentation.
INVEST
«Invest in good stories» definiert sechs Kriterien, die uns helfen, fachliches Wissen so kompakt und vollständig wie möglich zu vermitteln.
KISS
«Keep it simple, stupid» besagt, dass wir eine möglichst einfache Beschreibung für Inhalte wählen sollen. «Weniger ist mehr» sagt schon ein Sprichwort. Einfachheit ist die Kunst, die Menge nicht getaner Arbeit zu maximieren.
Layout
Der Baustein Layout enthält Entwürfe oder Skizzen eines Teils der Bedienoberfläche. Layout ist der Oberbegriff für eine ganze Reihe spezialisierter Ausprägungen, z.B. Ansicht und Dialog in einer Website oder Screen in einer Smartphone-App. Window, Panel, Prompt und Widget, u.s.w. sind wiederverwendbare Muster in einem Layout.
Leser
Leser ist jede am Produkt interessierte Partei. Ein Leser nutzt das Wiki als Hilfsmittel zur Erfüllung seiner Aufgaben im agilen Entwicklungsprozess. Das Wiki ist für ihn eine unverzichtbare Quelle für Produktwissen. Jeder Leser ist berechtigt, im Wiki Seiten zu lesen und zu kommentieren.
Linksammlung
PLA
«Principle of least astonishment» spiegelt sich im Aufbau der Seiten im Wiki wider. Jeder Baustein hat genau einen Zweck, festgelegte Abschnitte und ist das Ergebnis eines bestimmten Prozesses.
Produkt
Das Produkt ist das kundenwirksam eingeführte Produktinkrement. Es ist gleichzeitig die Vision für zukünftige Produktinkremente.
Produktdokumentation
Eine Produktdokumentation umfasst Dokumente, die den Zustand eines Produktinkrements in einem Wiki beschreibt.
Produktinkrement
Ein Produktinkrement ist eine lauffähige, getestete, angemessen dokumentierte und gemäß einer DOD überprüfte und freigegebene Version des Produktes.
Produktverantwortung
Produktverantwortung bezeichnet die Verantwortung einer Person für ein Produkt entlang des Produktlebenszyklus bis hin zu seinem geplanten Ende. Sie ist Hüter der Vision des Produktes und Ansprechpartner für interessierte Parteien für Veränderungen des Produktes.
Projekt
Ein Projekt ist nach üblicher Definition ein einmaliges Vorhaben mit einem bestimmten Ziel, in dem eine temporäre Projektorganisation Leistungen erbringt. Das Vorhaben hat einen Beginn und ein Ende.
Projektdokumentation
Eine Projektdokumentation umfasst Dokumente, die der Produktverantwortliche oder sein Team für die Planung und Steuerung von Veränderungen am Produkt benötigen.
Projektorganisation
Eine Projektorganisation umfasst alle Personen, die in einem Projekt an der Veränderung des Produktes zusammenarbeiten.
Policy
Der Baustein Policy wird verwendet, um konsequent alle Regeln für die Zusammenarbeit und den Einsatz von Anwendungen und Werkzeugen zu dokumentieren. Regeln sind Ausdruck der Qualitätspolitik in der Organisation.
Service
SLA
«Single level of abstraction» spiegelt sich in der Struktur des Wiki wider. Für jede Seite ist klar definiert, was in einer Seite beschrieben wird und was nicht in diese Seite gehört.
SOC
«Separation of concerns» führt dort zu einer Trennung fachlicher und technischer Dokumentation, wo es Sinn macht.
SRP
«Single responsibility principle» regelt die Verantwortung für den Inhalt im Wiki. Eine Seite hat immer genau einen Autor. Er ist für den Inhalt der Seite verantwortlich, bis sie «fertig» ist.
Systembeschreibung
In den Bausteinen der Systembeschreibung werden die Grenzen des IT-Systems definiert und alle Fähigkeiten der Software vollständig, widerspruchsfrei und hierarchisch erfasst. Fähigkeit ist der Sammelbegriff für Anwendungsfälle, besonderen Situationen und bekannten und akzeptierten Fehler eines IT-Systems.
Systemstruktur
Die Bausteine der Systemstruktur haben das Ziel, die Struktur der Software korrekt zu erfassen und einen Überblick über das Zusammenspiel der Dienste und Objekte zu geben. Ein nachrichten-orientierter Architekturstil ergibt eine andere Systemstruktur als die Realisierung eines IT-Systems mit einem monolithischen Applikationsservers.
Task
Glossar
Topic
Der Baustein Topic beschreibt einen klar abgegrenzten Aufgabenbereich (engl. scope), in dem das IT-System Verwendung findet. Er vermittelt einen Überblick und nimmt Bezug auf die Unternehmensprozesse. Er bündelt eine mit den Anforderungen wachsende Menge von Funktionalitäten, die im Detail mit dem Baustein Epic dokumentiert werden.