Mida haldate peale dokumendi?
Dokument on vaid üks viis otsuse jäädvustamiseks. Samuti tuleb teada, millistes punktides on kokku lepitud, millised on veel ettepanekud, kes vastab küsimustele ja mis muutub punkti muutmisel. See aitab vältida olukorda, kus sama taotlust tõlgendatakse eri moodi ja selle põhjal tehakse erinevat tööd.
Sama lähenemisviis võib aidata rakenduste arendamisel, sisemiste tööriistade, tootetingimuste ja töökorraldusreeglite puhul. Alustage ühest funktsioonist või töövoost, mitte ärge püüdke kõike korraga dokumenteerida.
Ühendage eesmärk, nõue, spetsifikatsioon ja vastuvõtukriteeriumid
Meeskonnad kasutavad neid mõisteid erinevalt. Selles näites kirjeldab nõue vajalikku tulemust või piirangut, spetsifikatsioon fikseerib kokkulepitud käitumise ning vastuvõtukriteeriumid selgitavad, kuidas seda kontrollida. Leppige nende tähendustes kokku inimestega, kellega koos töötate.
Eesmärk: vähendada käsitsi ümberkirjutamist
Igakuine aruandlus hõlmab praegu kirjete käsitsi kopeerimist. Eksportimise eesmärk on seda tööd lihtsustada.
Nõue: eksportige aruande jaoks vajalikud kirjed
Töötaja peab saama eksportida valitud kuu kirjed talle lubatud juurdepääsu piires.
Spetsifikatsioon: määratlege fail ja selle käitumine
Leppige kokku veergudes, järjestuses, tekstikodeeringus, kuupäevavormingus, tühjade tulemuste käsitlemises ja vigades. Need on selle näite valikud, mitte universaalsed vaikeseaded.
Vastuvõtukriteeriumid: tehke tulemus kontrollitavaks
Valmistage ette teadaolevate kuupäevade ja õigustega kirjed, eksportige need ning võrrelge väljundit kokkulepitud tulemusega.
Kirjuta iga punkti kohta üks kontrollitav mõte
Väljend „Muuda eksportimine mugavaks” jätab olulised valikud lahtiseks. Eralda ajavahemiku valimine, väljundväljade määramine, vastete puudumise käsitlemine ja juurdepääsu kontrollimine, kui neid saab iseseisvalt muuta või kinnitada.
Kasutage sõnade „kiire” või „lihtne” asemel konkreetseid tingimusi. Kui vastamisaja eesmärk on oluline, märkige lisaks arvule üles ka töökoormus, keskkond ja mõõtmismeetod. Märkige veel otsustamata väärtused selgelt otsustamata väärtusteks.
Enne: “Luba CSV eksport.”
Pärast: „Eksportige valitud kuu kokkulepitud veergude ja sortimisjärjestusega. Määratlege tühjad tulemused ja juurdepääsukontrollid eraldi punktides.“
Muudetud sõnastus toob välja valikud, milles tuleb kokku leppida, ning hõlbustab töö määramist ja ülevaatamist. Enne rakendamist on siiski vaja konkreetseid väljademääratlusi.
Väike väljade komplekt alustamiseks
ID, pealkiri ja kirjeldus
Anna igale üksusele püsiv ID, näiteks REQ-001. Märgi teema, tingimus ja oodatav tulemus. Püsiv ID võimaldab üksusele viidata ka pärast selle pealkirja muutmist.
Põhjus ja allikas
Märkige üles, millist probleemi element lahendab ja kust see pärineb, näiteks vestlusest, taotlusest või toetavast dokumendist.
Prioriteet ja ulatus
Erista selle väljalaske jaoks vajalikku sellest, mis võib oodata. Selgita prioriteedi põhjust; ära määra igale punktile kõrgeimat prioriteeti.
Vastutaja ja otsuse olek
Märgi üles, kes üksust täpsustab ja kas see on mustand, ülevaatamisel või kokku lepitud. Rakendamise eest vastutaja ja kinnitaja võivad olla erinevad inimesed.
Vastuvõtukriteeriumid ja seotud teave
Siduge element asjakohaste spetsifikatsioonide, kujunduste, ülesannete ja kontrollikirjetega. Hoidke need lingid nõude muutumisel ajakohasena.
Näide: kolm nõuet igakuisele CSV-ekspordile
Järgnev on näitlik näide. Väljade nimed ja käitumine tuleb kokku leppida loodava toote jaoks; näide ei ole kõigi ekspordifunktsioonide täielik spetsifikatsioon.
REQ-001: valitud kuu kirjed
Näidisspetsifikatsioon: kasutage kokkulepitud tööajavööndis valitud kuud ning eksportige ID, kirje kuupäev ja pealkiri UTF-8 vormingus, sorteerituna esmalt kuupäeva ja seejärel ID järgi. Vastuvõtukriteeriumi näide: kolm sobivat kirjet annavad ühe päiserea ja täpselt need kolm andmerida, ilma teiste kuude kirjeteta.
REQ-002: sobivaid kirjeid pole
Näidisspetsifikatsioon: eksportige kokkulepitud päiserida ka siis, kui ükski kirje ei vasta tingimustele. Vastuvõtunäide: tühi testandmestik loob faili, mis sisaldab seda päist, kuid mitte ühtegi andmerida. Kui eelistate faili asemel teadet, leppige selline teistsugune käitumine kokku ja dokumenteerige see.
REQ-003: juurdepääsu kontrollitakse enne eksportimist
Näidisspetsifikatsioon: ekspordiõiguseta kasutajad ei saa faili luua ning lubatud ulatusest väljapoole jäävaid kirjeid ei kaasata. Vastuvõtunäited peaksid hõlmama nii ekspordiõiguseta kasutajat kui ka kasutajat, kelle ligipääs kirjetele on piiratud.
Kasutage hierarhiat üksikuid otsuseid kaotamata
Rühmitage üksused eesmärgi või funktsiooni alusel ja paigutage üksikasjalikud tingimused vastava rühma alla. Näiteks: Aruandlus → Igakuine CSV-eksport → Sihtkirjed / Failivorming / Tühjad tulemused / Juurdepääs. Taustteave ja lahtised küsimused lisage märkustesse, mitte ühte pikka nõudesse.
Kui üks tingimus mõjutab mitut funktsiooni, säilitage selge viide kokkulepitud versioonile, selle asemel et kopeerida eri versioone igasse jaotisse. Enne selle muutmist kontrollige, millised järgnevad spetsifikatsioonid ja kontrollpunktid sellest sõltuvad.
Hoidke kokkulepe, teostus ja kontroll eraldi
„Kokkulepitud“ tähendab, et sisu on kavandatud ulatuse jaoks heaks kiidetud. See ei tähenda, et funktsioon oleks rakendatud. „Rakendatud“ ei kinnita, et kokkulepitud vastuvõtukriteeriumid on täidetud või funktsioon välja antud. Hoia need erinevused nähtavana ka siis, kui kasutad lihtsat olekute loendit.
Vaadake üle tavaolukord, tühjad või puuduvad sisendid, õigused ja vajaduse korral väliste süsteemide tõrked. Otsustage, milliseid tõendeid säilitada, kes neid kontrollib ja kes võib lahendamata küsimuse sulgeda.
Salvestage muudatus ja selle mõju enne, kui peate seda kokkulepituks
Uus taotlus jääb ettepanekuks, kuni vastutavad inimesed lepivad kokku, kuidas seda käsitleda. Pange kirja muudatuse põhjus, mõjutatud ID-d ning mõju tööle, kuupäevadele, spetsifikatsioonidele ja kontrollimisele. Arvestage ka sellega, kas muudatus kehtib kirjetele või kasutajatele, kes funktsiooni juba kasutavad.
Pärast otsuse tegemist uuendage kehtivat spetsifikatsiooni ja teavitage mõjutatud inimesi. Säilitage varem kokkulepitud versioon või muudatuse märkus, kui peate selgitama, mis muutus. Ärge eeldage, et tööriist salvestab kõik heakskiidud ja parandused automaatselt.
Valige koht, mida saate ajakohasena hoida
Väikese nimekirja jaoks võib piisata jagatud dokumendist või arvutustabelist. Kui arutelu, teostus ja kontroll toimuvad mitmes tööriistas, valige peamine viiteallikas ning linkige sellega seotud materjalid. Oluline on, et kõik leiaksid praegu kokkulepitud sisu.
Kasutage AI-d mustandi jaoks ja seejärel kinnitage otsused
Tehisintellekt aitab koostada võimalike nõuete loendit, korrastada mustandit ja pakkuda puuduvaid küsimusi. Eristage päringus kinnitatud faktid oletustest ning paluge jätta veel otsustamata väärtused küsimustena. Vaadake tulemus üle koos inimestega, kes tunnevad kavandatud kasutust.
ReqSpec AI-s saad nõudeid ja spetsifikatsioone hierarhiliselt korraldada ning kasutada tehisintellekti nende loomise, muutmise ja kontrollimise toetamiseks. Küsi konkreetne küsimus, näiteks „Millised tühja tulemuse tingimused on veel määratlemata?” Käsitle iga vastust soovitusena, mida tuleb kontrollida registreeritud sisu alusel, mitte heakskiidu või täielikkuse tõendina.
Alustage ühest funktsioonist ja ühest ülevaatusest
Valige üks funktsioon, loetlege vajalikud tulemused, andke punktidele ID-d ning lisage vastuvõtukriteeriumid ja lahtised küsimused. Vaadake see korra asjaomase inimesega üle ning pange seejärel kirja otsused ja järgmine vastutaja. Väike, ajakohasena hoitav kogum on kasulikum kui suur dokument, mida keegi ei uuenda.
Korraldage nõuded ja spetsifikatsioonid ReqSpec AI abil
ReqSpec AI pakub lihtsat viisi nõuete ja spetsifikatsioonide korraldamiseks mobiilis ja veebis. Tutvuge selle võimalustega rakenduse lehel.