Mitä hallinnoit asiakirjan lisäksi?
Asiakirja on vain yksi tapa kirjata päätös. Lisäksi on tiedettävä, mistä kohdista on sovittu, mitkä ovat vielä ehdotuksia, kuka vastaa kysymyksiin ja mikä muuttuu, kun kohtaa tarkistetaan. Näin vältetään työskentely saman pyynnön erilaisten tulkintojen pohjalta.
Sama lähestymistapa voi auttaa sovelluskehityksessä, sisäisissä työkaluissa, tuote-ehdoissa ja toimintatavoissa. Aloita yhdestä ominaisuudesta tai työnkulusta sen sijaan, että yrittäisit dokumentoida kaiken kerralla.
Yhdistä tavoite, vaatimus, määrittely ja hyväksymiskriteerit
Tiimit käyttävät näitä termejä eri tavoin. Tässä esimerkissä vaatimus kuvaa tarvittavaa tulosta tai rajoitetta, määrittely kirjaa sovitun toiminnan ja hyväksymiskriteerit selittävät, miten se tarkistetaan. Sopikaa näistä merkityksistä yhdessä työskentelevien ihmisten kesken.
Tavoite: vähentää manuaalista kopiointia
Kuukausiraportoinnissa tietueita kopioidaan tällä hetkellä käsin. Viennin tarkoituksena on helpottaa tätä työtä.
Vaatimus: vie raporttiin tarvittavat tietueet
Työntekijän on vietävä valitun kuukauden tietueet niiden tietojen osalta, joihin hänellä on käyttöoikeus.
Määrittely: määritä tiedosto ja sen toiminta
Sopikaa sarakkeista, järjestyksestä, tekstin merkistökoodauksesta, päivämäärämuodosta, tyhjien tulosten käsittelystä ja virheistä. Nämä ovat tätä esimerkkiä koskevia valintoja, eivät yleispäteviä oletusasetuksia.
Hyväksymiskriteerit: tee tuloksesta todennettava
Valmistele tietueet, joiden päivämäärät ja käyttöoikeudet ovat tiedossa, vie ne ja vertaa tulosta sovittuun lopputulokseen.
Kirjoita yksi tarkistettava ajatus kuhunkin kohtaan
Ilmaus kuten ”Tee viennistä kätevää” jättää tärkeitä valintoja avoimiksi. Erota ajanjakson valinta, tulostekenttien määrittely, tilanteet ilman osumia ja käyttöoikeuksien tarkistaminen, kun näitä voidaan muuttaa tai tarkistaa toisistaan riippumatta.
Käytä konkreettisia ehtoja sanojen ”nopea” tai ”helppo” sijaan. Jos tavoitevasteaika on tärkeä, kirjaa numeron lisäksi työkuorma, ympäristö ja mittausmenetelmä. Merkitse päättämättömät arvot selvästi päättämättömiksi.
Ennen: “Salli CSV-vienti.”
Jälkeen: ”Vie valittu kuukausi sovituilla sarakkeilla ja lajittelujärjestyksellä. Määrittele tyhjät tulokset ja käyttöoikeustarkistukset erillisinä kohtina.”
Tarkennettu sanamuoto osoittaa päätökset, joista on sovittava, ja helpottaa työn jakamista ja tarkistamista. Ennen toteutusta tarvitaan silti konkreettiset kenttien määritelmät.
Pieni joukko kenttiä alkuun
ID, otsikko ja kuvaus
Anna jokaiselle kohteelle pysyvä ID, kuten REQ-001. Ilmoita aihe, ehto ja odotettu tulos. Pysyvä ID helpottaa kohteeseen viittaamista myös otsikon muuttumisen jälkeen.
Syy ja lähde
Kirjaa, minkä ongelman kohde ratkaisee ja mistä se on peräisin, esimerkiksi keskustelusta, pyynnöstä tai tausta-asiakirjasta.
Prioriteetti ja laajuus
Erota, mikä on tarpeen tässä julkaisussa ja mikä voi odottaa. Perustele prioriteetti; älä anna kaikille kohdille korkeinta prioriteettia.
Vastuuhenkilö ja päätöksen tila
Kirjaa, kuka tarkentaa kohdetta ja onko se luonnos, tarkistettavana vai hyväksytty. Toteutuksesta vastaava ja hyväksyjä voivat olla eri henkilöitä.
Hyväksymiskriteerit ja niihin liittyvät tiedot
Linkitä kohde olennaisiin määrittelyihin, suunnitelmiin, tehtäviin ja tarkistustietoihin. Pidä linkit ajan tasalla vaatimuksen muuttuessa.
Esimerkki: kolme vaatimusta kuukausittaiselle CSV-viennille
Seuraava on havainnollistava esimerkki. Kenttien nimistä ja toiminnasta on sovittava kehitettävän tuotteen mukaan; esimerkki ei ole kaikkien vientitoimintojen täydellinen määrittely.
REQ-001: valitun kuukauden tietueet
Esimerkkimääritys: käytä valittua kuukautta sovitulla liiketoiminnan aikavyöhykkeellä ja vie ID, tietueen päivämäärä ja otsikko UTF-8-muodossa lajiteltuna ensin päivämäärän ja sitten ID:n mukaan. Hyväksymisesimerkki: kolme vastaavaa tietuetta tuottaa yhden otsikkorivin ja täsmälleen nämä kolme tietoriviä ilman muiden kuukausien tietueita.
REQ-002: ei vastaavia tietueita
Esimerkkimäärittely: vie sovittu otsikkorivi tiedostoon, vaikka yhtään vastaavaa tietuetta ei löytyisi. Hyväksymisesimerkki: tyhjä testiaineisto tuottaa tiedoston, jossa on kyseinen otsikko mutta ei tietorivejä. Jos haluat tiedoston sijaan viestin, sovi tästä poikkeavasta toiminnasta ja dokumentoi se.
REQ-003: käyttöoikeus tarkistetaan ennen vientiä
Esimerkkimäärittely: käyttäjät, joilla ei ole vientioikeutta, eivät voi luoda tiedostoa, eikä sallittuun alueeseen kuulumattomia tietueita sisällytetä siihen. Hyväksymisesimerkkien tulee kattaa sekä käyttäjä, jolla ei ole vientioikeutta, että käyttäjä, jonka pääsy tietueisiin on rajoitettu.
Käytä hierarkiaa kadottamatta yksittäisiä päätöksiä
Ryhmittele kohteet tarkoituksen tai ominaisuuden mukaan ja sijoita yksityiskohtaiset ehdot asianomaisen ryhmän alle. Esimerkiksi: Raportointi → Kuukausittainen CSV-vienti → Kohdetietueet / Tiedostomuoto / Tyhjät tulokset / Käyttöoikeus. Kirjaa taustatiedot ja avoimet kysymykset muistiinpanoihin sen sijaan, että yhdistäisit ne yhdeksi pitkäksi vaatimukseksi.
Jos yksi ehto vaikuttaa useisiin ominaisuuksiin, säilytä selkeä viittaus sovittuun versioon sen sijaan, että kopioisit eri versioita jokaiseen osioon. Tarkista ennen muutosta, mitkä myöhemmät määrittelyt ja tarkistuskohdat riippuvat siitä.
Pidä sopiminen, toteutus ja varmistus erillään
”Sovittu” tarkoittaa, että sisältö on hyväksytty suunniteltuun laajuuteen. Se ei tarkoita, että ominaisuus olisi toteutettu. ”Toteutettu” ei osoita, että sovitut hyväksymiskriteerit on täytetty tai että ominaisuus on julkaistu. Pidä nämä erot selvästi näkyvillä, vaikka käyttäisit yksinkertaista tilaluetteloa.
Tarkista normaali tilanne, tyhjät tai puuttuvat syötteet, käyttöoikeudet ja tarvittaessa ulkoiset virheet. Päätä, mitkä todisteet säilytetään, kuka ne tarkistaa ja kuka voi sulkea ratkaisemattoman kysymyksen.
Kirjaa muutos ja sen vaikutukset ennen kuin pidät sitä hyväksyttynä
Uusi pyyntö on ehdotus, kunnes vastuuhenkilöt sopivat, miten se käsitellään. Kirjaa muutoksen syy, muutoksen kohteena olevat ID:t sekä vaikutukset työhön, päivämääriin, määrittelyihin ja todentamiseen. Harkitse myös, koskeeko muutos tietueita tai käyttäjiä, jotka jo käyttävät ominaisuutta.
Päivitä päätöksen jälkeen nykyinen määrittely ja ilmoita muutoksesta niille, joita se koskee. Säilytä aiemmin sovittu versio tai muutosmerkintä, kun sinun on selitettävä, mikä muuttui. Älä oleta, että työkalu tallentaa automaattisesti jokaisen hyväksynnän ja tarkistuksen.
Valitse paikka, jonka voit pitää ajan tasalla
Pieneen listaan voi riittää jaettu asiakirja tai laskentataulukko. Jos keskustelu, toteutus ja varmistus jakautuvat useisiin työkaluihin, valitse ensisijainen viite ja linkitä siihen liittyvät materiaalit. Tärkeintä on, että kaikki voivat tunnistaa kulloinkin sovitun sisällön.
Tee luonnos AI:n avulla ja vahvista sitten päätökset
Tekoäly voi auttaa listaamaan mahdollisia vaatimuksia, jäsentämään luonnosta ja ehdottamaan puuttuvia kysymyksiä. Erota kehotteessa vahvistetut tosiasiat oletuksista ja pyydä jättämään vielä päättämättömät arvot kysymyksiksi. Käy tulos läpi niiden kanssa, jotka tuntevat suunnitellun käyttötarkoituksen.
ReqSpec AI:ssa voit järjestää vaatimukset ja määrittelyt hierarkkisesti sekä hyödyntää tekoälyä niiden luomisen, muokkaamisen ja tarkistamisen tukena. Esitä tarkennettu kysymys, kuten ”Mitkä tyhjien tulosten ehdot ovat vielä määrittelemättä?” Käsittele jokaista vastausta ehdotuksena, joka on tarkistettava tallennettua sisältöä vasten, ei todisteena hyväksynnästä tai täydellisyydestä.
Aloita yhdestä ominaisuudesta ja yhdestä tarkistuksesta
Valitse yksi ominaisuus, luettele tarvittavat tulokset, anna kohdille ID:t ja lisää hyväksymiskriteerit sekä avoimet kysymykset. Käy kokonaisuus kerran läpi asianomaisen henkilön kanssa ja kirjaa sitten päätökset sekä seuraava vastuuhenkilö. Pieni, ylläpidetty kokonaisuus on hyödyllisempi kuin suuri asiakirja, jota kukaan ei päivitä.
Järjestä vaatimukset ja määrittelyt ReqSpec AI:n avulla
ReqSpec AI tarjoaa helpon tavan järjestää vaatimuksia ja määrittelyjä mobiilissa ja verkossa. Tutustu ominaisuuksiin sovelluksen sivulla.