Ką valdote be dokumento?
Dokumentas yra tik vienas būdas užfiksuoti sprendimą. Taip pat reikia žinoti, dėl kurių punktų susitarta, kurie dar yra pasiūlymai, kas atsakys į klausimus ir kas pasikeis, kai punktas bus peržiūrėtas. Tai padeda išvengti darbo remiantis skirtingomis tos pačios užklausos interpretacijomis.
Tas pats metodas gali padėti kuriant programėles, vidinius įrankius, produkto sąlygas ir veiklos taisykles. Pradėkite nuo vienos funkcijos ar darbo eigos, užuot bandę viską dokumentuoti iš karto.
Susiekite tikslą, reikalavimą, specifikaciją ir priėmimo kriterijus
Komandos šiuos terminus vartoja skirtingai. Šiame pavyzdyje reikalavimas nusako reikalingą rezultatą ar apribojimą, specifikacija užfiksuoja sutartą veikimą, o priėmimo kriterijai paaiškina, kaip jį patikrinti. Su kartu dirbančiais žmonėmis susitarkite dėl šių reikšmių.
Tikslas: sumažinti rankinį duomenų perrašymą
Šiuo metu rengiant mėnesines ataskaitas įrašus tenka kopijuoti rankomis. Eksportavimo tikslas – palengvinti šį darbą.
Reikalavimas: eksportuoti ataskaitai reikalingus įrašus
Darbuotojui reikia eksportuoti pasirinkto mėnesio įrašus neviršijant jam suteiktų prieigos teisių.
Specifikacija: apibrėžkite failą ir jo veikimą
Susitarkite dėl stulpelių, jų eiliškumo, teksto koduotės, datos formato, elgesio, kai rezultatų nėra, ir klaidų tvarkymo. Tai šio pavyzdžio pasirinkimai, o ne visuotinės numatytosios nuostatos.
Priėmimo kriterijai: padarykite rezultatą patikrinamą
Paruoškite įrašus su žinomomis datomis ir leidimais, atlikite eksportavimą ir palyginkite rezultatą su sutartu rezultatu.
Kiekvienam punktui parašykite po vieną patikrinamą mintį
Tokia frazė kaip „Padaryti eksportavimą patogų“ palieka svarbius sprendimus neapibrėžtus. Atskirkite laikotarpio pasirinkimą, išvesties laukų parinkimą, atvejų be atitikmenų tvarkymą ir prieigos tikrinimą, jei šiuos dalykus galima keisti ar tikrinti nepriklausomai.
Vietoj tokių žodžių kaip „greitas“ ar „lengvas“ naudokite konkrečias sąlygas. Jei svarbus atsako laiko tikslas, kartu su skaičiumi nurodykite darbo krūvį, aplinką ir matavimo metodą. Dar nenuspręstas reikšmes aiškiai pažymėkite kaip nenustatytas.
Prieš: „Leisti eksportuoti CSV.“
Po: „Eksportuokite pasirinktą mėnesį naudodami sutartus stulpelius ir rūšiavimo tvarką. Tuščius rezultatus ir prieigos patikras apibrėžkite atskirais punktais.“
Patikslinta formuluotė įvardija pasirinkimus, dėl kurių reikia susitarti, ir palengvina užduočių paskirstymą bei peržiūrą. Prieš įgyvendinimą dar reikia konkrečių laukų apibrėžčių.
Keli laukai pradžiai
ID, pavadinimas ir aprašymas
Kiekvienam elementui suteikite pastovų ID, pavyzdžiui, REQ-001. Nurodykite temą, sąlygą ir laukiamą rezultatą. Pastovus ID leidžia į elementą kreiptis net pakeitus jo pavadinimą.
Priežastis ir šaltinis
Užfiksuokite problemą, kurią sprendžia elementas, ir jo kilmę, pavyzdžiui, pokalbį, prašymą ar patvirtinantį dokumentą.
Prioritetas ir apimtis
Atskirkite tai, ko reikia šiai versijai, nuo to, kas gali palaukti. Paaiškinkite prioritetų priežastis; nesuteikite viskam aukščiausio prioriteto.
Atsakingas asmuo ir sprendimo būsena
Užrašykite, kas patikslins elementą ir ar jis yra juodraštis, peržiūrimas, ar jau suderintas. Už įgyvendinimą atsakingas asmuo ir tvirtintojas gali būti skirtingi žmonės.
Priėmimo kriterijai ir susijusi informacija
Susiekite elementą su atitinkamomis specifikacijomis, projektais, užduotimis ir tikrinimo įrašais. Pasikeitus reikalavimui, atnaujinkite šias nuorodas.
Pavyzdys: trys mėnesinio CSV eksporto reikalavimai
Toliau pateikiamas tik iliustracinis pavyzdys. Laukų pavadinimus ir veikimą reikia suderinti pagal kuriamą produktą; šis pavyzdys nėra išsami visų eksportavimo funkcijų specifikacija.
REQ-001: pasirinkto mėnesio įrašai
Specifikacijos pavyzdys: naudokite pasirinktą mėnesį pagal sutartą verslo laiko juostą ir eksportuokite ID, įrašo datą bei pavadinimą UTF-8 formatu, surikiuotus pirmiausia pagal datą, o tada pagal ID. Priėmimo pavyzdys: trys tinkami įrašai turi sudaryti vieną antraštės eilutę ir tiksliai tris duomenų eilutes, be kitų mėnesių įrašų.
REQ-002: atitinkančių įrašų nėra
Specifikacijos pavyzdys: eksportuokite sutartą antraštės eilutę net tada, kai nėra atitinkančių įrašų. Priėmimo pavyzdys: tušti bandomieji duomenys sukuria failą su ta antrašte ir be duomenų eilučių. Jei vietoj failo pageidaujate pranešimo, susitarkite dėl tokio kitokio veikimo ir jį dokumentuokite.
REQ-003: prieiga patikrinama prieš eksportuojant
Specifikacijos pavyzdys: eksporto leidimo neturintys naudotojai negali sukurti failo, o įrašai, nepatenkantys į leistiną sritį, neįtraukiami. Priėmimo pavyzdžiai turėtų apimti naudotoją be eksporto leidimo ir naudotoją, kurio prieiga prie įrašų ribota.
Naudokite hierarchiją neprarasdami atskirų sprendimų
Sugrupuokite elementus pagal paskirtį ar funkciją, tada išsamias sąlygas pateikite atitinkamoje grupėje. Pavyzdžiui: Ataskaitos → Mėnesinis CSV eksportas → Tiksliniai įrašai / Failo formatas / Tušti rezultatai / Prieiga. Kontekstą ir neišspręstus klausimus rašykite pastabose, o ne suplakite į vieną ilgą reikalavimą.
Jei viena sąlyga veikia kelias funkcijas, išlaikykite aiškią nuorodą į suderintą versiją, užuot kopijavę skirtingas versijas į kiekvieną skyrių. Prieš ją keisdami patikrinkite, kurios vėlesnės specifikacijos ir tikrinimo punktai nuo jos priklauso.
Atskirkite susitarimą, įgyvendinimą ir patikrinimą
„Sutarta“ reiškia, kad turinys priimtas numatytai apimčiai. Tai nereiškia, kad funkcija įgyvendinta. „Įgyvendinta“ taip pat nepatvirtina, kad sutarti priėmimo kriterijai įvykdyti arba funkcija išleista. Šiuos skirtumus aiškiai parodykite net ir naudodami paprastą būsenų sąrašą.
Patikrinkite įprastą atvejį, tuščią arba trūkstamą įvestį, leidimus ir, jei aktualu, išorinių sistemų klaidas. Nuspręskite, kokius įrodymus saugoti, kas juos tikrins ir kas gali užbaigti neišspręstą klausimą.
Užfiksuokite pakeitimą ir jo poveikį prieš laikydami jį suderintu
Nauja užklausa laikoma pasiūlymu, kol atsakingi asmenys sutaria, kaip ją tvarkyti. Užfiksuokite pakeitimo priežastį, paveiktus ID ir poveikį darbui, datoms, specifikacijoms bei tikrinimui. Taip pat apsvarstykite, ar pakeitimas taikomas įrašams arba naudotojams, kurie jau naudojasi šia funkcija.
Priėmę sprendimą, atnaujinkite dabartinę specifikaciją ir informuokite susijusius žmones. Išsaugokite ankstesnę suderintą versiją arba pakeitimų pastabą, kai reikės paaiškinti, kas pasikeitė. Nemanykite, kad įrankis automatiškai užfiksuoja kiekvieną patvirtinimą ir pataisą.
Pasirinkite vietą, kurią galėsite nuolat atnaujinti
Nedideliam sąrašui gali pakakti bendrinamo dokumento ar skaičiuoklės. Jei aptarimas, įgyvendinimas ir tikrinimas vyksta keliuose įrankiuose, pasirinkite pagrindinį informacijos šaltinį ir iš jo pateikite nuorodas į susijusią medžiagą. Svarbiausia, kad visi galėtų atpažinti šiuo metu suderintą turinį.
Naudokite AI juodraščiui, tada patvirtinkite sprendimus
DI gali padėti sudaryti galimų reikalavimų sąrašą, sutvarkyti juodraštį ir pasiūlyti trūkstamus klausimus. Užklausoje atskirkite patvirtintus faktus nuo prielaidų ir paprašykite neapsispręstas reikšmes palikti klausimų forma. Rezultatą peržiūrėkite su žmonėmis, išmanančiais numatytą naudojimo būdą.
„ReqSpec AI“ galite hierarchiškai tvarkyti reikalavimus ir specifikacijas, o AI naudoti kaip pagalbą juos kuriant, redaguojant ir tikrinant. Užduokite konkretų klausimą, pavyzdžiui, „Kurios tuščio rezultato sąlygos dar neapibrėžtos?“ Bet kurį atsakymą laikykite pasiūlymu, kurį reikia patikrinti pagal užregistruotą turinį, o ne patvirtinimo ar išsamumo įrodymu.
Pradėkite nuo vienos funkcijos ir vienos peržiūros
Pasirinkite vieną funkciją, išvardykite reikalingus rezultatus, suteikite punktams ID ir pridėkite priėmimo kriterijus bei neatsakytus klausimus. Kartą peržiūrėkite juos su susijusiu asmeniu, tada užfiksuokite sprendimus ir kitą atsakingą asmenį. Nedidelis, nuolat prižiūrimas rinkinys naudingesnis už didelį dokumentą, kurio niekas neatnaujina.
Tvarkykite reikalavimus ir specifikacijas su ReqSpec AI
ReqSpec AI siūlo paprastą būdą tvarkyti reikalavimus ir specifikacijas mobiliajame įrenginyje bei žiniatinklyje. Funkcijas rasite programėlės puslapyje.