Čo spravujete okrem dokumentu?
Dokument je len jeden zo spôsobov, ako zaznamenať rozhodnutie. Potrebujete tiež vedieť, ktoré body sú odsúhlasené, ktoré sú stále návrhmi, kto odpovie na otázky a čo sa zmení, keď sa niektorý bod upraví. Pomáha to predchádzať práci založenej na rôznych výkladoch tej istej požiadavky.
Rovnaký prístup môže pomôcť pri vývoji aplikácií, interných nástrojoch, podmienkach produktu a prevádzkových pravidlách. Začnite jednou funkciou alebo pracovným postupom namiesto pokusu zdokumentovať všetko naraz.
Prepojte cieľ, požiadavku, špecifikáciu a akceptačné kritériá
Tímy používajú tieto pojmy rôznymi spôsobmi. V tomto príklade požiadavka opisuje potrebný výsledok alebo obmedzenie, špecifikácia zaznamenáva dohodnuté správanie a akceptačné kritériá vysvetľujú, ako ho overiť. Dohodnite sa na týchto významoch s ľuďmi, s ktorými spolupracujete.
Cieľ: obmedziť ručný prepis
Proces mesačného vykazovania v súčasnosti zahŕňa ručné kopírovanie záznamov. Účelom exportu je túto prácu uľahčiť.
Požiadavka: exportujte záznamy potrebné do správy
Zamestnanec potrebuje exportovať záznamy za vybraný mesiac v rozsahu, ku ktorému má povolený prístup.
Špecifikácia: definujte súbor a jeho správanie
Dohodnite sa na stĺpcoch, poradí, kódovaní textu, formáte dátumu, správaní pri prázdnom výsledku a chybách. Ide o voľby pre tento príklad, nie o univerzálne predvolené nastavenia.
Akceptačné kritériá: zabezpečte overiteľnosť výsledku
Pripravte záznamy so známymi dátumami a oprávneniami, vykonajte export a porovnajte výstup s dohodnutým výsledkom.
Ku každej položke napíšte jednu overiteľnú myšlienku
Formulácia ako „Zjednodušte export“ necháva dôležité rozhodnutia otvorené. Oddeľte výber obdobia, výber výstupných polí, riešenie prípadov bez zhôd a kontrolu prístupu, ak je možné tieto položky nezávisle meniť alebo overovať.
Namiesto slov ako „rýchly“ alebo „jednoduchý“ používajte konkrétne podmienky. Ak je dôležitý cieľ času odozvy, zaznamenajte okrem čísla aj pracovnú záťaž, prostredie a metódu merania. Nerozhodnuté hodnoty jasne označte ako nerozhodnuté.
Predtým: „Povoliť export CSV.“
Po úprave: „Exportujte vybraný mesiac pomocou dohodnutých stĺpcov a poradia zoradenia. Prázdne výsledky a kontroly prístupu definujte ako samostatné položky.“
Upravená formulácia označuje možnosti, na ktorých sa treba dohodnúť, a uľahčuje prideľovanie a kontrolu práce. Pred implementáciou sú stále potrebné konkrétne definície polí.
Malá sada polí na začiatok
ID, názov a popis
Každej položke priraďte stabilné ID, napríklad REQ-001. Uveďte predmet, podmienku a očakávaný výsledok. Stabilné ID umožňuje odkazovať na položku aj po zmene názvu.
Dôvod a zdroj
Zaznamenajte problém, ktorý položka rieši, a odkiaľ pochádza, napríklad z rozhovoru, požiadavky alebo podporného dokumentu.
Priorita a rozsah
Oddeľte to, čo je potrebné pre toto vydanie, od toho, čo môže počkať. Vysvetlite dôvod priority; nedávajte každej položke najvyššiu prioritu.
Zodpovedná osoba a stav rozhodnutia
Zaznamenajte, kto položku objasní a či je vo fáze návrhu, kontroly alebo odsúhlasenia. Osoba zodpovedná za realizáciu a schvaľovateľ môžu byť rôzni ľudia.
Akceptačné kritériá a súvisiace informácie
Prepojte položku s príslušnými špecifikáciami, návrhmi, úlohami a záznamami o overení. Keď sa zmenia požiadavky, tieto odkazy aktualizujte.
Príklad: tri požiadavky na mesačný export CSV
Nasleduje ilustračný príklad. Názvy polí a správanie je potrebné dohodnúť pre produkt, ktorý vytvárate; tento príklad nie je úplnou špecifikáciou každej funkcie exportu.
REQ-001: záznamy za vybraný mesiac
Príklad špecifikácie: použite vybraný mesiac v dohodnutom pracovnom časovom pásme a exportujte ID, dátum záznamu a názov v kódovaní UTF-8, zoradené najprv podľa dátumu a potom podľa ID. Príklad akceptácie: tri zodpovedajúce záznamy vytvoria jeden riadok hlavičky a presne tieto tri riadky údajov, bez záznamov z iných mesiacov.
REQ-002: žiadne zodpovedajúce záznamy
Príklad špecifikácie: exportujte dohodnutý riadok hlavičky aj vtedy, keď sa nenájdu žiadne zodpovedajúce záznamy. Príklad akceptácie: prázdne testovacie údaje vytvoria súbor s touto hlavičkou a bez dátových riadkov. Ak uprednostňujete správu namiesto súboru, dohodnite sa na takomto odlišnom správaní a zdokumentujte ho.
REQ-003: prístup sa kontroluje pred exportom
Príklad špecifikácie: používatelia bez povolenia na export nemôžu vytvoriť súbor a záznamy mimo povoleného rozsahu sa nezahrnú. Akceptačné príklady by mali pokrývať používateľa bez povolenia na export aj používateľa s obmedzeným prístupom k záznamom.
Použite hierarchiu bez straty jednotlivých rozhodnutí
Zoskupte položky podľa účelu alebo funkcie a pod príslušnú skupinu umiestnite podrobné podmienky. Napríklad: Vykazovanie → Mesačný export CSV → Cieľové záznamy / Formát súboru / Prázdne výsledky / Prístup. Kontext a otvorené otázky uveďte v poznámkach namiesto toho, aby ste ich miešali do jednej dlhej požiadavky.
Ak jedna podmienka ovplyvňuje viacero funkcií, ponechajte jasný odkaz na odsúhlasenú verziu namiesto kopírovania rôznych verzií do každej časti. Pred jej zmenou zistite, ktoré nadväzujúce špecifikácie a kontrolné položky od nej závisia.
Oddeľte dohodu, implementáciu a overovanie
„Dohodnuté“ znamená, že obsah bol schválený pre zamýšľaný rozsah. Neznamená to, že funkcia bola implementovaná. „Implementované“ nepotvrdzuje, že boli splnené dohodnuté akceptačné kritériá alebo že funkcia bola vydaná. Zachovajte tieto rozdiely viditeľné, aj keď používate jednoduchý zoznam stavov.
Skontrolujte bežný prípad, prázdne alebo chýbajúce vstupy, oprávnenia a prípadné externé zlyhania. Rozhodnite, aké dôkazy uchovať, kto ich preverí a kto môže uzavrieť nevyriešenú otázku.
Predtým, než zmenu považujete za dohodnutú, zaznamenajte ju aj jej dopad
Nová požiadavka zostáva návrhom, kým sa zodpovedné osoby nedohodnú, ako s ňou naložiť. Zaznamenajte dôvod zmeny, dotknuté ID a vplyv na prácu, termíny, špecifikácie a overovanie. Zvážte aj to, či sa zmena vzťahuje na záznamy alebo používateľov, ktorí už funkciu používajú.
Po rozhodnutí aktualizujte aktuálnu špecifikáciu a informujte dotknutých ľudí. Ak potrebujete vysvetliť, čo sa zmenilo, uchovajte predchádzajúcu odsúhlasenú verziu alebo poznámku o zmene. Nepredpokladajte, že nástroj automaticky zaznamenáva každé schválenie a revíziu.
Vyberte miesto, ktoré dokážete udržiavať aktuálne
Pri malom zozname môže stačiť zdieľaný dokument alebo tabuľka. Ak sú diskusia, implementácia a overovanie rozdelené medzi viacero nástrojov, vyberte hlavný referenčný zdroj a prepojte s ním súvisiace materiály. Dôležité je, aby každý vedel identifikovať aktuálne odsúhlasený obsah.
Použite AI na návrh a potom potvrďte rozhodnutia
AI môže pomôcť zostaviť zoznam možných požiadaviek, usporiadať návrh a navrhnúť chýbajúce otázky. V zadaní oddeľte potvrdené fakty od predpokladov a požiadajte, aby nerozhodnuté hodnoty zostali vo forme otázok. Výsledok skontrolujte s ľuďmi, ktorí poznajú zamýšľané použitie.
V ReqSpec AI môžete hierarchicky usporiadať požiadavky a špecifikácie a využívať AI na podporu tvorby, úprav a kontroly. Položte konkrétnu otázku, napríklad „Ktoré podmienky pre prázdne výsledky ešte nie sú definované?“ Každú odpoveď považujte za návrh, ktorý treba overiť oproti zaznamenanému obsahu, nie za dôkaz schválenia alebo úplnosti.
Začnite jednou funkciou a jednou kontrolou
Vyberte jednu funkciu, spíšte potrebné výsledky, priraďte položkám ID a pridajte akceptačné kritériá a otvorené otázky. Raz to prejdite s príslušnou osobou, potom zaznamenajte rozhodnutia a ďalšiu zodpovednú osobu. Malý, priebežne udržiavaný súbor je užitočnejší než veľký dokument, ktorý nikto neaktualizuje.
Usporiadajte požiadavky a špecifikácie pomocou ReqSpec AI
ReqSpec AI ponúka jednoduchý spôsob organizovania požiadaviek a špecifikácií v mobile aj na webe. Preskúmajte funkcie na stránke aplikácie.