Lernmaterialien für 4 Dokumentation von Anforderungen an der IU Internationale Hochschule

• Ziel ist: die Sicherung des aktuellen Erkenntnisstands
• Gewonnenes Wissen soll nicht nur in den Köpfen der beteiligten sein, sondern von allen Projektbeteiligten einsehbar sein
• Sehr wichtig: Unterstützung der Kommunikation innerhalb des Softwareprojekts

• Anforderungen haben zentrale Bedeutung, von ihnen sind alle folgenden Aktivitäten abhängig
• Anforderungen haben rechtliche Relevanz, vergabe von Dienstleistungen an externe, auf dieser Basis werden Verträge geschlossen, im Streitfall können diese Dokumentationen herangezogen werden
• Menge der Anforderungen sehr komplex, IT-Systeme haben tausende Anforderungen die teilweise Abhängig voneinander sind
• Verfügbarkeit der Anforderungen muß über Projekt- und Systemlaufzeit gewährleistet sein => Menge der Personen am Projekt verändern sich, neue Personen müßen sich schnell einarbeiten können

• Mit Dokumentation soll Kommunikation im Softwareprojekt unterstützt werden
• Daher vor Dokumentation Zweck und Zielgruppe bestimmen
• Je nach Projektsituation können Zweck und Zielgruppe variieren

• Als Kommunikationsunterstützung => wenn Anforderungen geklärt und priorisiert werden müßen oder Anforderungen Architekten und Entwicklern übergeben wird
• Wissensspeicher und Referenz für Beschlüsse und Definitionen => damit nach Inbetriebnahme zur Wartung und Weiterentwicklung ursprüngliche Anforderungen nachgelesen werden können
• Verbindlichkeit von Aussagen und Klärung im Streitfall => damit es ein Dokument gibt das als gemeinsame Vereinbarung anerkannt wird

• Eignet sich für Dokumentation von Anforderungen an Benutzerschnittstellen
• kann auch direkt als Dokumentationsform eingesetzt werden
• Es kann z.B.: Größe, Position, Farbe, Beschriftung von Elementen der Nutzeroberfläche präzise festgelegt werden
• GUI-Prototypen können auf verschiedene Ebenen eingesetzt werden von einfachen Skizzen über Wireframes bis hin zu Mockups

• In der Praxis kommt für die dokumentation von Anforderungen eine Mischung von Modellen, Text und GUI-Prototypen zum Einsatz
• Die Mischform gleicht Nachteile der einzelnen Formen aus.
• Wichtig ist Text und Modelle sollen gleichen Erkenntnisstand haben und nicht Inkonsistent sein

Auf Basis der vorhergehenden Aktivitäten können nun in einer für Zweck und Zielgruppe geeigneten Form dokumentiert werden

• Projekte ziehen sich über mehrere Wochen und Monate hinweg
• daher ist es wichtig nach Abschluss, kritisch prüfen ob Ergebnis noch zum ursprünglichen Zweck und Ziel angemessen ist
• Es kommt häufig vor das ursprüngliche Zweck aus Augen verliert
• Es passiert häufig das Änderungen zu Zielgruppe und Zweck während der Dokumentation ergeben => daher Dokumentation auf Bedingungen anpassen.

• es gibt keine Einheitliche Struktur, die in allen Projekten genutzt werden kann
• Häufig gibt es Verbindliche Empfehlungen für die Gliederung der Anforderungsdokumentation, damit soll erreicht werden dass Anforderungen projektübergreifend vergleichbar beschrieben werden.
• Vorteile: Erleichtert Einarbeitung sowie das Zurechtfinden in den Dokumentationen, vorgegebene Struktur kann als Checkliste verwendet werden