Séria: Ako písať dokumentáciu a manuály v IT projekte
Tester hlási bug:
„Export nefunguje.“
Vývojár odpovie:
„U nás funguje.“
Support doplní:
„U iných zákazníkov to ide.“
Nakoniec sa zistí:
funkcionalita je upravená len pre konkrétneho klienta.
V dokumentácii je popísaný „štandardný systém“.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Support dostane otázku:
„Prečo u nás funguje export inak ako u iného klienta?“
Support nevie odpovedať.
Začne zisťovať:
Nakoniec sa ukáže:
Ale táto informácia:
Dokumentácia nerozlišuje:
Všetko je zmiešané.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Používateľ si otvorí manuál.
Nájde funkcionalitu, ktorú v systéme nemá.
Volá support:
„Prečo to u mňa nefunguje?“
Support zisťuje:
„To máme len u klienta XY.“
Tester si myslí, že je to bug.
Vývojár tvrdí, že je to custom.…
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
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.“…
Séria: Ako písať dokumentáciu a manuály v IT projekte
V predchádzajúcich článkoch sme pomenovali dva problémy:
Najčastejšie sa miešajú tieto veci:
Výsledok je jeden veľký dokument, ktorý síce existuje, ale nikto sa v ňom nevie orientovať.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
V predchádzajúcich článkoch sme si ukázali dve veci:
Teraz sa pozrime na problém, ktorý je menej viditeľný – ale v produktových firmách veľmi častý.…
