Die Methode cards+ ist der Versuch, mit einer festen Struktur und Prinzipien und Praktiken der Entwickler Effizienz und Qualität in die Erstellung und Pflege einer Produktdokumentation zu bringen. cards+ definiert keinen eigenen Prozess, sondern verbindet Prozesse für Anforderungsanalyse und agile Entwicklung, um wertvolles Produktwissen während der Durchführung eines Projekts direkt von den Wissensträgern einzusammeln und als Produktdokumentation in einem Wiki zur Verfügung zu stellen. cards+ gibt eine sehr einfache Struktur für eine Produktdokumentation in einem Wiki vor. Ein Glossar ist zentraler Bestandteil. https://www.xing.com/communities/groups/agil-dokumentieren-2ec4-1084817 ist eine moderierte Gruppe auf XING zur Diskussion von cards+ und agiler Dokumentation.

1. AGIL
DOKUMENTIEREN
MIT CARDS+

2. Agil?

3. Wir sind agil, weil wir Wissen
erfassen, wann es entsteht, von den
Personen, die es erarbeiten.

4. Wir sind agil, weil wir uns
laufend verbessern und
voneinander lernen.

5. Wir begrüßen Veränderungen.
Alle sind betroffen.
Alles ist betroffen.
Programmieren, Testen und
Dokumentieren ist eine Aufgabe
für das ganze Team.

6. Einfach?

7. Wir verwenden ein Wiki, mit einer
klaren, einfachen Struktur.

8. Die Hemmschwelle für
Änderungen ist so gering wie
möglich.

9. Das Verfassen einer Dokumentation
erfordert viele Fähigkeiten, die
einen guten Entwickler
auszeichnen: KISS, DRY, und nicht
zuletzt die Pfadfinderregel.

10. Prüfbar?

11. Änderungen an den
Dokumenten müssen für jeden
nachvollziehbar sein.

12. Wir wollen Feedback zu jeder
Zeit, von jeder Person im Team.

13. Wir nutzen das Feedback für die
kontinuierliche
Verbesserung der
Dokumentation.

14. Wir nutzen Reviews, um Fehler
in der Dokumentation frühzeitig zu
finden.

15. Sauber?

16. Eine saubere
Produktdokumentation enthält nur
gültige Dokumente.

17. Saubere
Produktdokumentation

18. Verdorbene Dokumente sind
wie toter Code.
Sie verwirren uns.
Sie führen zu
Fehleinschätzungen.

19. Schlimm an Verdorbenen
Dokumenten ist, dass wir nicht immer
erkennen, dass sie verdorben sind!

20. Konzept
Toter Code
UML
Diagramm
Komponenten-
spezifikation

21. Wir beschränken uns auf das
Notwendige. Aber das tun wir
in hoher Qualität.

22. Wertvoll?

23. Dokumentation ist wie Code
am Ende eines Sprints „fertig“.

25. Die konsequente Pflege eines
Glossar hilft uns, eine
gemeinsame Sprache
zu entwickeln, von Stakeholdern,
für alle interessierten Parteien.

26. Wir nutzen das Glossar, um
im Produkt eine gemeinsame
Domänensprache zu
etablieren.

27. cards+
Feste Struktur
Produktwissen
Hohe Qualität
Freie Struktur
Viel Wissen
Große Vielfalt

28. cards+ ist der Versuch, mit einer
festen Struktur und bewährten
Prinzipien und Praktiken
Effizienz und Qualität in eine
Produktdokumentation zu
bringen.

29. cards+ integriert Code als
wesentlichen Teil der
Produktdokumentation.
Lesbarer Code ist wertvolles
Wissen höchster Qualität.
Im Code steckt die Wahrheit!

30. cards+ integriert Testfälle
als wesentlichen Teil der
Produktdokumentation.
Testfälle beschreiben die wahren
Fähigkeiten des Produktes.

31. Effektiv bedeutet “das Richtige zu
tun”, effizient ist es aber erst, wenn
man “das Richtige” richtig tut!
cards+ hilft dabei.

32. cardsplus.info