CARDS+

Month: September 2015

Was beschreibt der Baustein Case?

Mit einer Anforderung drückt ein Stakeholder einen aus seiner Sicht wichtigen Bedarf an einer Erweiterung oder Änderung des Software-Produktes aus. In der Analyse der Anforderung wollen Product-Owner, Business-Analysten und das cross-funktionale Team einen Einblick in das fachliche Problem bekommen und ein gemeinsames Verständnis über Ziele und Lösungen entwickeln. Wir machen uns auch Gedanken über die Auswirkungen der Umsetzung. Das Sammeln von relevanten Informationen (das Produktwissen) und das Einholen von Feedback aus den Fachabteilungen ist ein ganz wichtiger Teil der Analyse.

Ein Case ist das Ergebnis von Entscheidungen aus dem Backlog-Management agiler Software-Entwicklung.

In der Methode CARDS+ untersuchen wir jede Anforderung vom Groben (als Epic) ins Feine (als Case). Über den beiden schwebt noch die Zuordnung zum Aufgabenbereich (als Topic).

Continue reading

Was beschreibt der Baustein Manual?

Das Benutzerhandbuch ist das “Buch”, in dem die Bedienung der Software für die Nutzer beschrieben ist. Es ist Teil der Produktdokumentation. Projekte planen die Aktualisierung des Benutzerhandbuches gerne so spät wie möglich. In Projekten mit klassischen Vorgehensmodell  (“Wasserfall”) ist sowas noch einigermaßen gut planbar. Mit den agilen Methoden in den Projekten ergibt sich das Problem, dass am Ende des Sprints auch das Benutzerhandbuch fertig sein muss. Das ist meiner Ansicht nach nur schwer leistbar, weil der Großteil der Arbeit in der Gestaltung des Inhaltes liegt – fehlerfreie Inhalte vorausgesetzt. Oft ist die Gestaltung des Benutzerhandbuches und die Art der Veröffentlichung an Vorgaben des Unternehmens gebunden. Es ist auch schwer vorstellbar, dass jedes cross-funktionale Team die Rolle des technischen Redakteurs besetzen kann, wie es für ein professionelles Handbuch notwendig ist.

Im Zusammenhang mit der Spezifikation von Benutzeroberflächen der Anwendung unterscheiden wir Layouts und Manuals. Beide Artefakte haben das Ziel, die Benutzeroberfläche zu beschreiben.

In einem Manual beschreiben wir die Verwendung der Benutzeroberfläche, also das gewünschte fachliche Verhalten aus Sicht der Nutzer. Manuals sind als ideal geeignet, um daraus Testfälle abzuleiten. Aus diesem Grund werden während der Realisierung einer Benutzeroberfläche – hier verwenden wir die Layouts – für den Test bereits die Manuals erstellt. Wir legen für jeden Anwendungsfall, der durch die Akzeptanzkriterien einer User-Story gefordert wird, ein Manual an und beschreiben dort aus Sicht des Nutzers die besonderen Randbedingungen für die Verwendung der Benutzeroberfläche.

Continue reading

Ich bezeichne nicht-funktionale Anforderungen lieber als „Einschränkung” eines Systems.
Mike Cohn
Logo Redenswerte

Wir haben den ersten Sprint hinter uns gebracht. Ein Sprint, bei dem das Team zum ersten Mal mit Ergebnissen der Methode CARDS+ gearbeitet hat. Pirmin Ofner (kurz PO), unser Product-Owner, hat sich Gedanken zum Ergebnis des Sprints gemacht.

Continue reading

Agil dokumentieren! Von Jazz inspiriert

Sie fragen sich jetzt, was hat agil dokumentieren mit Jazz zu tun. Nun, ich will es kurz erklären. Kürzlich habe ich das Jazzfestival in Saalfelden besucht. Im Besonderen war es die Session von Steve Coleman, die mich über ein paar Dinge im Zusammenhang mit agilem dokumentieren nachdenken ließen. Wie es dem Charakter des Festivals entspricht, handelte es sich um modernen Jazz. Moderner Jazz ist komplex. Steve Coleman ist einer der wichtigsten Sucher im modernen Jazz, einer der stets für Überraschungen gut ist.

Aber ich will jetzt nicht die musikalische Qualität des Konzertes beurteilen. Ich habe mich gefragt, wie diese Gruppe Menschen es schafft, ein komplexes Musikstück zu entwickeln und gemeinsam so virtuos umzusetzen.

Continue reading

Die Hemmschwelle für Änderungen an der Dokumentation muss so gering wie möglich sein. Die Änderungen müssen aber nachvollziehbar sein.

Was ist mit der Hygiene?

Hygiene ist der Sammelbegriff für Maßnahmen zur Erhaltung der Sauberkeit. Die Methode CARDS+ definiert solche Maßnahmen im Zusammenhang mit der Erstellung und Pflege einer Produktdokumentation.

12 Was ist mit der Hygiene

Ich habe mich in einem früheren Beitrag mit der Frage beschäftigt, was mit der Qualität von Dokumenten passiert, die wir in einer irgendwie gearteten Ablage für eine gewisse Zeit speichern und zu einem späteren Zeitpunkt wieder hervorholen. Ein Dokument verliert immer mehr Qualität, je länger es unverändert liegen bleibt, während sich das Produkt weiterentwickelt. Es verdirbt. Schlimm an verdorbenen Dokumenten ist, dass wir sie nicht als solche erkennen.

Was bedeutet aber Hygiene für eine Produktdokumentation?
Continue reading

Copyright © 2018 Impressum Datenschutz

Zum Anfang ↑