Prüfen und Abstimmen
Aus Cascade
Die Prüfung von Artefakten im Verlauf der Anforderungsdokumentation und die Anforderungsdokumentation sind zu prüfen. Im dazu durchzuführenden Review sind die Anforderungen auf ihre Qualität hin zu prüfen, Fehler und Lücken sind zu finden. Perspektivbasiertes Lesen oder der Bau von Prototypen können diesen Vorgang unterstützen. Unabdingbar sind Checklisten. Diese ermöglichen einen formalisierten Review-Prozess.
Checkliste (maximal eine Seite) als Strukturierungsmittel für den Review sollte folgende fünf Kriterien bedienen:
- Qualitätsaspekte: Inhalt, Dokumentation, Abgestimmtheit
- Prinzipien der Prüfung: Beteiligung der richtigen Stakeholder, Trennung von Fehlersuche und Korrektur, Prüfung aus unterschiedlichen Sichten, geeigneter Wechsel der Dokumentationsform, Konstruktion von Entwicklungsartefakten, Wiederholte Prüfung
- Qualitätskriterien für das Dokument: Eindeutigkeit und Konsistenz, Klare Struktur, Modifizierbarkeit und Erweiterbarkeit, Vollständigkeit, Verfolgbarkeit
- Qualitätskriterien für die Anforderung: Abgestimmt, bewertet, eindeutig, gültig und aktuell, korrekt, konsistent, prüfbar, realisierbar, verfolgbar, vollständig, verständlich
- Berücksichtigung der Erfahrungen / Hinweise der Reviewer
Das Abstimmen von Anforderungen erfordert Fähigkeiten im Umgang mit Konflikten. Redaktionelle Einigung ist schnell gefunden. Schwerer wiegt der Konfliktfall. Der Konfliktfall muss identifiziert, analysiert, gelöst und dokumentiert werden. Nur durch den vollen Kreislauf kann ein unendlicher Reviewprozess vermieden werden, der immer wieder am gleichen Konfliktfall ansetzt. Konfliktfälle müssen kleinteilig gelöst werden. Die Konfliktlösung hängt vom Ergebnis der Analyse ab: ist es bspw. ein Sachkonflikt, Interessenskonflikt oder Beziehungskonflikt?
In die Konfliktlösung sind alle Stakeholder einzubeziehen. Die Lösung kann in einer Einigung derart bestehen, dass sich der Konflikt durch Erklärung auflösen lässt oder ein Kompromiss gefunden wird. Der Kompromiss wird durch das Machtgefüge beeinflusst. Die Auflösung ist zu prüfen. Der Prozess ist zu dokumentieren.
Der Prozess der Dokumentenprüfung muss folgenden Regeln genügen:
- Zuerst erfolgt der formale (automatisierte) Review
- Formal akzeptierte Dokumente werden einem standardisierten Peer Review unterzogen
- Für jedes Dokument sind fachliche, IT-seitige und betriebsseitige Gutachter zu bestimmen
- Für komplexe Dokumente wird ein formalisierter und mehrschrittiger Review Prozess definiert
- Wenig komplexe Dokumente können in einem Walkthrough-Workshop geprüft werden
- Ein Schreibtischtest wird für alle Dokumenttypen empfohlen.
Grundsätzlich gilt:
- Jedes Dokument muss einzeln verständlich sein (d.h., ohne Rückgriff auf Detail-Dokumente; Detail-Dokumente müssen aber verfügbar sein)
- Die Verwendung von Begriffen, insbesondere fachlichen Begriffen, ist zu prüfen.
- Missverständnisse und Unklarheiten müssen zu Änderungen im Dokument führen, auch wenn sie mündlich geklärt werden
- Fehler müssen klassifiziert werden
- Jeder Review endet mit einer Freigabe-Empfehlung
