Ďalší základ pre dokumentáciu a príručky
Séria: Ako písať dokumentáciu a manuály v IT projekte
Na projekte sa pripraví špecifikácia.
Obsahuje:
Vývoj začne implementovať.
Po čase sa objavia otázky:
Séria: Ako písať dokumentáciu a manuály v IT projekte
Tester otvorí špecifikáciu.
„Používateľ môže upraviť objednávku.“
Bez ďalších detailov.
Tester sa pýta:
Odpovede:
Séria: Ako písať dokumentáciu a manuály v IT projekte
Na projekte vznikne funkcionalita.
User story existuje.
Vývoj ju implementuje.
Tester ju otestuje.
A potom:
Používateľ nevie, že existuje.
Manuál ju opisuje inak.
Release notes ju spomenú neurčito.
Support nevie, ako sa správa.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Na projekte sa rieši nová funkcionalita.
User story je zapísaná.
Špecifikácia vznikne.
Vývoj implementuje.
Po čase sa tester pýta:
„Prečo to funguje len u klienta XY?“
„Je to bug alebo feature?“
„Platí to pre všetkých alebo len pre jedného zákazníka?“…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Na projekte sa objaví nová funkcionalita.
Analytik pripraví user story a krátku špecifikáciu.
Vývoj začne implementovať.
Tester pripraví test cases až keď je funkcionalita hotová.
A vtedy sa objavia otázky:
Séria: Ako písať dokumentáciu a manuály v IT projekte
Na projekte sa objaví nové zadanie.
User story má tri vety.
Akceptačné kritériá sú dve odrážky.
„Treba pridať export údajov.“
Vývojár sa opýta analytika, ako to má fungovať.
Tester sa opýta vývojára, čo vlastne implementoval.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
V projekte sa začne vyvíjať nová funkcionalita.
Analytik napíše krátky popis do úlohy v Jire.
Vývojár si ho vysvetlí jedným spôsobom.
Tester iným.
A zákazník očakáva ešte niečo tretie.
Keď príde čas písať dokumentáciu, objaví sa zvláštna situácia:
nikto vlastne presne nevie, ako má funkcionalita fungovať.…
