user story

Dokumentácia a používateľské príručky, User story a akceptačné kritériá

Ako rozoznať dobré vs slabé user story a akceptačné kritériá (praktické ukážky)

Séria: Ako písať dokumentáciu a manuály v IT projekte

Minimálny model riešenia

Najjednoduchší spôsob, ako zlepšiť kvalitu zadania, je porovnať slabé a dobré príklady.
Na prvý pohľad často vyzerajú podobne, ale rozdiel v zrozumiteľnosti pre tím je veľký.

Nižšie je niekoľko typických situácií z projektov.…

Dokumentácia a používateľské príručky, User story a akceptačné kritériá

Ako z user story a akceptačných kritérií vznikajú testy, dokumentácia a release notes (Epic → Story → Task → Bug v Jire)

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

V projekte pribudne nová funkcionalita.

V Jire existuje Epic, niekoľko user story a pár taskov. Vývoj prebehne, tester pripraví testy a funkcionalita sa nasadí do produkcie.

Potom príde moment, keď treba pripraviť:

  • text do používateľského manuálu
  • informáciu pre support
  • release notes k novej verzii

A tím začne hľadať, kde vlastne je napísané:

  • čo mala funkcionalita robiť
  • pre koho bola určená
  • aké sú výnimky
  • čo sa v systéme zmenilo

Časť informácií je v user story.…

Dokumentácia a používateľské príručky, User story a akceptačné kritériá

Core vs Custom už na úrovni user story

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Nový tester v projekte otvorí user story a vidí funkcionalitu, ktorá sa zdá byť súčasťou produktu.

Otestuje ju, napíše test case a pripraví poznámky do dokumentácie.

O niekoľko dní sa dozvie, že:

„To je špeciálna úprava pre klienta XY.“…

Návrat hore