Čime upravljate osim dokumentom?
Dokument je samo jedan način bilježenja odluke. Također morate znati koje su stavke dogovorene, koje su još prijedlozi, ko će odgovarati na pitanja i šta se mijenja kada se neka stavka revidira. To pomaže da se izbjegne rad zasnovan na različitim tumačenjima istog zahtjeva.
Isti pristup može pomoći u razvoju aplikacija, internim alatima, uslovima proizvoda i operativnim pravilima. Počnite s jednom funkcijom ili radnim procesom umjesto da pokušavate dokumentovati sve odjednom.
Povežite cilj, zahtjev, specifikaciju i kriterije prihvatanja
Timovi koriste ove pojmove na različite načine. U ovom primjeru zahtjev opisuje potreban rezultat ili ograničenje, specifikacija bilježi dogovoreno ponašanje, a kriteriji prihvatanja objašnjavaju kako ga provjeriti. Usaglasite ova značenja s ljudima s kojima radite.
Cilj: smanjiti ručno prepisivanje
Mjesečno izvještavanje trenutno uključuje ručno prepisivanje zapisa. Svrha izvoza je da taj posao olakša.
Zahtjev: izvezite zapise potrebne za izvještaj
Član osoblja treba izvesti zapise za odabrani mjesec, u okviru podataka kojima ima dopušten pristup.
Specifikacija: definišite datoteku i njeno ponašanje
Dogovorite kolone, redoslijed, kodiranje teksta, format datuma, postupanje s praznim rezultatima i greške. To su odluke za ovaj primjer, a ne univerzalne zadane postavke.
Kriteriji prihvatanja: učinite rezultat provjerljivim
Pripremite zapise s poznatim datumima i dozvolama, izvršite izvoz i uporedite rezultat s dogovorenim ishodom.
Napišite jednu provjerljivu ideju po stavci
Izraz poput „Učinite izvoz praktičnim” ostavlja važne odluke otvorenim. Odvojite izbor perioda, izbor izlaznih polja, postupanje kada nema podudaranja i provjeru pristupa ako se te stavke mogu nezavisno mijenjati ili provjeravati.
Koristite konkretne uslove umjesto riječi poput „brzo” ili „lako”. Ako je ciljano vrijeme odziva važno, zabilježite opterećenje, okruženje i način mjerenja, kao i brojčanu vrijednost. Vrijednosti o kojima još nije odlučeno jasno označite kao neodređene.
Prije: “Omogući izvoz u CSV.”
Poslije: „Izvezite odabrani mjesec koristeći dogovorene kolone i redoslijed sortiranja. Definišite prazne rezultate i provjere pristupa kao zasebne stavke.“
Izmijenjena formulacija prepoznaje odluke koje treba usaglasiti i olakšava dodjelu i pregled posla. Prije implementacije i dalje su potrebne konkretne definicije polja.
Mali skup polja za početak
ID, naslov i opis
Svakom elementu dodijelite stalan ID, poput REQ-001. Navedite predmet, uslov i očekivani rezultat. Stalan ID omogućava pozivanje na element i nakon promjene naslova.
Razlog i izvor
Zabilježite problem koji stavka rješava i odakle potiče, poput razgovora, zahtjeva ili pratećeg dokumenta.
Prioritet i opseg
Razlikujte ono što je potrebno za ovo izdanje od onoga što može čekati. Objasnite razlog prioriteta; nemojte svakoj stavci dati najviši prioritet.
Odgovorna osoba i status odluke
Zabilježite ko će pojasniti element i je li riječ o nacrtu, elementu na pregledu ili usaglašenom elementu. Osoba zadužena za implementaciju i ona koja odobrava mogu biti različite.
Kriteriji prihvatanja i povezane informacije
Povežite stavku s relevantnim specifikacijama, dizajnima, zadacima i zapisima o provjeri. Održavajte te veze ažurnim kada se zahtjev promijeni.
Primjer: tri zahtjeva za mjesečni izvoz CSV-a
Slijedi ilustrativan primjer. Nazive polja i ponašanje treba usaglasiti za proizvod koji razvijate; ovaj primjer nije potpuna specifikacija za svaku funkciju izvoza.
REQ-001: zapisi za odabrani mjesec
Primjer specifikacije: koristite odabrani mjesec u dogovorenoj poslovnoj vremenskoj zoni i izvezite ID, datum zapisa i naslov u UTF-8, sortirano prvo po datumu, a zatim po ID-u. Primjer prihvatanja: tri odgovarajuća zapisa daju jedan red zaglavlja i tačno ta tri reda podataka, bez zapisa iz drugih mjeseci.
REQ-002: nema odgovarajućih zapisa
Primjer specifikacije: izvezite dogovoreni red zaglavlja čak i kada nema odgovarajućih zapisa. Primjer prihvatanja: prazan testni skup stvara datoteku s tim zaglavljem i bez redova podataka. Ako umjesto datoteke želite poruku, dogovorite i dokumentujte takvo drugačije ponašanje.
REQ-003: pristup se provjerava prije izvoza
Primjer specifikacije: korisnici bez dozvole za izvoz ne mogu generisati datoteku, a zapisi izvan dozvoljenog opsega nisu uključeni. Primjeri prihvatanja trebaju obuhvatiti korisnika bez dozvole za izvoz i korisnika kojem je pristup zapisima ograničen.
Koristite hijerarhiju bez gubljenja pojedinačnih odluka
Grupišite stavke prema svrsi ili funkciji, a zatim detaljne uslove stavite pod odgovarajuću grupu. Naprimjer: Izvještavanje → Mjesečni CSV izvoz → Ciljni zapisi / Format datoteke / Prazni rezultati / Pristup. Pozadinske informacije i otvorena pitanja stavite u bilješke umjesto da ih miješate u jedan dugačak zahtjev.
Ako jedan uslov utiče na više funkcija, zadržite jasnu referencu na dogovorenu verziju umjesto kopiranja različitih verzija u svaki odjeljak. Prije promjene provjerite koje naknadne specifikacije i stavke provjere zavise od njega.
Držite dogovor, implementaciju i provjeru odvojeno
„Dogovoreno“ znači da je sadržaj prihvaćen za predviđeni opseg. To ne znači da je funkcija implementirana. „Implementirano“ ne potvrđuje da su ispunjeni dogovoreni kriteriji prihvatanja niti da je funkcija objavljena. Neka ove razlike ostanu jasne čak i ako koristite jednostavnu listu statusa.
Pregledajte uobičajeni slučaj, prazan ili nedostajući unos, dozvole i, gdje je primjenjivo, kvarove vanjskih sistema. Odlučite koje dokaze čuvati, ko ih provjerava i ko može zatvoriti neriješeno pitanje.
Zabilježite promjenu i njen utjecaj prije nego što je smatrate dogovorenom
Novi zahtjev je prijedlog sve dok se odgovorne osobe ne dogovore kako će ga obraditi. Zabilježite razlog promjene, zahvaćene ID-ove i utjecaj na rad, datume, specifikacije i provjeru. Razmotrite i odnosi li se promjena na zapise ili korisnike koji već koriste funkciju.
Nakon odluke ažurirajte trenutnu specifikaciju i obavijestite osobe na koje se ona odnosi. Sačuvajte prethodnu dogovorenu verziju ili bilješku o promjeni kada trebate objasniti šta se promijenilo. Nemojte pretpostavljati da alat automatski bilježi svako odobrenje i reviziju.
Odaberite mjesto koje možete redovno ažurirati
Za malu listu može biti dovoljan zajednički dokument ili tabela. Kada su rasprava, implementacija i provjera raspoređene između više alata, odaberite glavni referentni izvor i povežite s njim relevantne materijale. Važno je da svi mogu prepoznati trenutno dogovoreni sadržaj.
Koristite AI za nacrt, a zatim potvrdite odluke
AI može pomoći da navedete moguće zahtjeve, organizujete nacrt i predložite pitanja koja nedostaju. U upitu odvojite potvrđene činjenice od pretpostavki i zatražite da neodlučene vrijednosti ostanu u obliku pitanja. Pregledajte rezultat s osobama koje poznaju namjeravanu upotrebu.
U ReqSpec AI možete hijerarhijski organizovati zahtjeve i specifikacije te koristiti AI kao podršku pri izradi, uređivanju i provjeri. Postavite konkretno pitanje poput „Koji uslovi za prazne rezultate još nisu definisani?” Svaki odgovor smatrajte prijedlogom koji treba provjeriti prema registrovanom sadržaju, a ne dokazom odobrenja ili potpunosti.
Počnite s jednom funkcijom i jednim pregledom
Odaberite jednu funkciju, navedite potrebne rezultate, dodijelite stavkama ID-ove i dodajte kriterije prihvatanja i otvorena pitanja. Jednom to pregledajte s relevantnom osobom, a zatim zabilježite odluke i sljedeću odgovornu osobu. Mali skup koji se redovno održava korisniji je od velikog dokumenta koji niko ne ažurira.
Organizirajte zahtjeve i specifikacije uz ReqSpec AI
ReqSpec AI pruža jednostavan način organiziranja zahtjeva i specifikacija na mobilnom uređaju i webu. Istražite funkcije na stranici aplikacije.