Zadanie: uprość plan testów API
Wymagania
Wybierz istniejący plan testów API, który jest zbyt długi albo zbyt sekwencyjny.
Przygotuj jego krótszą wersję, która odpowiada na pytania:
- co jest już pokryte,
- co można robić teraz,
- co można robić równolegle,
- co jest zablokowane,
- jaka decyzja odblokuje następny etap,
- które szczegóły należy przenieść do historii lub archiwum.
Sugerowana struktura
Użyj prostego układu:
# API Test Plan
## Baseline
## How To Split The Work
## Blocked Until
## Shared Decisions
## Delivery Order
## Test Rules
Jeśli masz dużo notatek historycznych, przenieś je do osobnego pliku, na przykład:
api-test-plan-history.md
Kryteria akceptacji
- Aktywny plan da się szybko przeczytać.
- Pierwszy ekran dokumentu pokazuje, co robić dalej.
- Plan rozróżnia pracę niezależną od pracy zablokowanej.
- Historyczne walidacje i eksploracje nie dominują dokumentu.
- Dokument zawiera konkretne endpointy, helpery albo decyzje, ale nie próbuje opisać wszystkiego.
- Jeśli plan dotyczy testów, zawiera komendę walidacyjną dla nowych testów i pełnego suite'u.
Opcjonalne rozszerzenie
Dodaj diagram Mermaid pokazujący tylko najważniejsze zależności.
Nie próbuj umieszczać na diagramie wszystkich endpointów. Diagram ma pomóc w decyzji, a nie zastąpić dokumentację API.