Den Fokus auf nachhaltige Artefakte legen

statt

Susanne Mühlbauer, HOOD GmbH 16.10.2013

Helping you to help yourself

Spezifikation Dokumentation

System

• Vorher • Vorgabe/ Plan • unterliegt

Änderungen

• Nachher • Beschreibt das „Ist“ • unterliegt

Änderungen

Implementierung

Spezifikation und Dokumentation


Dokumentation

Projekt-/ Prozess-

Dokumentation

Produkt-/ System-

Dokumentation

• Projektplan • Statusbericht • Meetingprotokolle • …

Vorgaben aus dem Entwicklungsprozess (z.B. RUP, V-Modell, …) • Konzepte • Anforderungsspezifikation • …

• Fachliche Doku • Technische Doku • Code

Warum Anforderungsspezifikation?

Arten von Dokumentation


• Basis für einen (Festpreis-) Vertrag

• Gemeinsames Verständnis

• Abnahme

• Auswirkungsanalyse für Änderungen

• Stets aktuelle Spezifikation des zu

entwickelnden Systems

• Wiederverwendung (z.B. Varianten,

Baukasten)

Warum gibt es Anforderungsspezifikationen? Einige Ziele:

?

?

?

Verstehen - Vereinbaren - Sicherstellen




• Abnahme


• Stets aktuelle Spezfikation des zu

entwickelnden Systems


Baukasten)

Können wir die Ziele auch mit anderen Artefakten erreichen, z.B. mit Dokumentation oder

Testfällen? ?

?

?



Wann wird Spezifikation zur Dokumentation?

Sprint

Spezifikation

Planungs- Meeting I und II

Dokumentation



Wann wird Dokumentation zur „Spezifikation“ ?

Sprint

Dokumentation




Sprint

-8-

Implementierung Code

Designanforderungen Designdoku

Systemanforderungen Systemdoku

Kundenanforderungen fachliche Doku Warum

Was

Wie

Abstraktionsebenen von Anforderungen und Dokumentation

Stakeholder/ Leser/ Autor



User Story


Was meine ich mit nachhaltigen Artefakten?

Entwicklungs-phase

Betriebs-, Wartungs- und Weiterentwicklungsphase

Softwarenutzung

Softwareentwicklung

Quelle: Andreas Rüping, Dokumentation in agilen Projekten, dpunkt.verlag

Langfristig relevantes Wissen


Beispiele für nachhaltige Artefakte

Auf allen Ebenen: • Motivation, Beweggründe • Optionen,

Entscheidungen/ Trade-Offs

• grober Überblick • Detailinformation

• Benutzerhandbuch • Fachliche Architektur • Szenarien/ fachliche

Use Cases • Q3 Testfälle*, z.B. User

Acceptance Tests • …

*Agile Testing Quadrant, Lisa Crispin

• Designprinzipien • Schichtenmodell • Frameworks • Coding Guidelines • Branching-/ Merging

Konzept • …

• Technische Architektur • Schnittstellen • Nicht-funktionale

Anforderungen • Q2 und Q4 Testfälle*, z.B.

funktionale Tests, Performance Tests

• …

• Code • Inline-Doku • Q1 Testfälle*, z.B. Unit

Tests • Modelle –> Reverse

Engineering • …


Im Systemkontext?

Komponente Komponente Komponente Komponente

Gesamtsystem


Worauf kommt es noch an?

Leser/ Adressaten/ Autoren

Was benutzen Sie schon? • Persönliches Gespräch • Photos • Review-Meeting • Wiki • Modellierungswerkzeuge • Anforderungsmanagement

- werkzeuge

• Test-Tools • …

Verteilte Teams




• Abnahme


• Stets aktuelle Dokumentation des

entwickelten Systems


Baukasten)

Können wir die Ziele auch mit anderen Artefakten erreichen, z.B. mit Dokumentation oder

Testfällen? ?

?

?


Spezifikation, Dokumentation und Test

zusammenbringen:

- Specification by Example - BDD - ATDD


Und was sonst noch so interessant sein könnte…

Hier erreicht Ihr mich:

Susanne Mühlbauer Tel: 0176/16611606

[email protected]

Quellen und interessante Lektüre: • Andreas Rüping, Dokumentation in agilen

Projekten • Uwe Friedrichsen, Was muss, was kann und

was geht gar nicht? Optimale Systemdokumentation mit agilen Prinzipien, Objektspektrum https://www.codecentric.de/kompetenzen/publikationen/optimale-systemdokumentation-mit-agilen-prinzipien/

• Lisa Crispin, Janet Gregory (2009). Agile Testing: A Practical Guide for Testers and Agile Teams

• Adzic, Gojko (2011). Specification by Example: How Successful Teams Deliver the Right Software.