1. Wymagane dokumenty (information items)
Norma wskazuje zestaw obowiązkowych typów specyfikacji, które powinny powstać w projekcie:
| Dokument | Cel |
| BRS – Business Requirements Specification | Określa potrzeby biznesowe / misję. |
| StRS – Stakeholder Requirements Specification | Zawiera wymagania interesariuszy. |
| OpsCon – Operational Concept Document | Opisuje kontekst operacyjny i sposób użycia systemu. |
| SyRS – System Requirements Specification | Zawiera wymagania systemowe. |
| SRS – Software Requirements Specification | Zawiera wymagania dla oprogramowania. |
2. Wymagane treści dokumentów
Norma precyzuje jakie sekcje i informacje muszą znaleźć się w każdym z dokumentów. W szczególności:
- Każda specyfikacja wymagań musi zawierać:
- Cel dokumentu
- Zakres
- Definicje, akronimy, skróty
- Kontekst systemu
- Wymagania funkcjonalne
- Wymagania niefunkcjonalne
- Ograniczenia i założenia
- Interfejsy
- Wymagania dotyczące walidacji i weryfikacji
- Atrybuty wymagań (opisane niżej)
3. Wymagane atrybuty każdego wymagania
ISO/IEC/IEEE 29148:2018 definiuje zestaw obowiązkowych atrybutów, które muszą być przypisane do każdego wymagania. Przykładowe atrybuty:
- Identyfikator (ID)
- Tekst wymagania
- Właściciel
- Priorytet
- Źródło
- Uzasadnienie (rationale)
- Trudność / złożoność
- Status
- Kryteria weryfikacji
4. Wymagania dotyczące jakości wymagań
Wymagania muszą być:
- jednoznaczne
- kompletne
- sprawdzalne
- osiągalne
- niezależne
- zrozumiałe
- spójne
- śledzalne
- nie rozwiązaniowe (solution-neutral)
5. Wymagania dotyczące procesów i zgodności
Norma wymaga, aby dokumentacja:
- była zgodna z procesami z ISO/IEC/IEEE 15288 (systemy) i 12207 (oprogramowanie)
- spełniała wymagania dotyczące dokumentów z ISO/IEC/IEEE 15289
- była tworzona w sposób umożliwiający śledzenie wymagań między poziomami (BRS → StRS → SyRS → SRS)
6. Wymagania dotyczące formatu dokumentów
Norma nie narzuca jednego sztywnego formatu, ale:
- określa wymagane sekcje
- podaje zalecenia dotyczące struktury
- dopuszcza różne formy (tekst, modele, diagramy)
- wymaga spójności i kompletności
7. Wymagania dotyczące zarządzania wymaganiami
Norma wymaga, aby dokumentacja wspierała:
- śledzenie zmian
- konfigurację wymagań
- powiązania między wymaganiami
- powiązania z testami
- powiązania z architekturą i projektowaniem
Podsumowanie
- Jakie dokumenty muszą powstać (BRS, StRS, OpsCon, SyRS, SRS)
- Jakie treści muszą zawierać (sekcje, typy wymagań, kontekst, interfejsy itd.)
- Jakie atrybuty musi mieć każde wymaganie (ID, źródło, priorytet, uzasadnienie itd.)
- Jakie cechy jakościowe muszą spełniać wymagania (jednoznaczność, weryfikowalność itd.)
- Jak dokumentacja musi wspierać procesy cyklu życia (zgodność z 15288, 12207, 15289)
- Jak powinna być strukturyzowana (wymagane sekcje + elastyczny format)
