Pidä päätöslokia Jirassa: muista, miksi valitsitte tämän lähestymistavan

Kuusi viikkoa julkaisun jälkeen joku kysyy, miksi tiimi valitsi sähköposti-ilmoitukset päivittäisen koosteen sijaan. Jira-tehtävät kertovat, mitä rakennettiin. Kommentti sanoo ”sovittu suunnittelussa”. Keskustelun muistavat henkilöt ovat kiireisiä, eikä kukaan ole varma ratkaisevasta rajoitteesta.

Päätösloki täyttää aukon. Se kirjaa tilanteen, vaihtoehdot, valinnan ja seuraukset paikkaan, jonka tiimi löytää. Power Packin Decision Logissa merkintä sijaitsee Jira-tehtävän vieressä, lähellä selittämäänsä työtä.

Opas seuraa kuvitteellista asiakasportaalitiimiä sen laatiessa hyödyllisen merkinnän, yhdistäessä sen toteutukseen ja palatessa siihen asiakastarpeiden muuttuessa.

Päätä, mikä ansaitsee merkinnän

Päätöslokin ei tarvitse tallentaa jokaista keskustelua. Aloita valinnoista, joita tulevat kollegat voivat perustellusti kyseenalaistaa: toimitustapa, riippuvuus, julkaisurajaus tai tietoinen kompromissi, jolla on yhtä pientä tehtävää laajemmat seuraukset.

Portaalitiimillemme ilmoitusten toimitus sopii tähän. Välittömän sähköpostin valinta vaikuttaa toteutukseen, testaukseen, tukiohjeisiin ja asiakasodotuksiin. Tiimi on harkinnut vaihtoehtoja ja odottaa palaavansa valintaan viestimäärän kasvaessa.

Painikkeen nimen kirjoitusvirheen korjaaminen ei sen sijaan todennäköisesti tarvitse omaa päätösmerkintää. Ero on käytännöllinen: auttaisiko perustelun ymmärtäminen jotakuta ylläpitämään, muuttamaan tai selittämään tulosta myöhemmin?

Arkkitehtuuripäätösten merkinnät eli ADR:t tarjoavat hyödyllisen esikuvan. Michael Nygardin alkuperäinen artikkeli kuvaa lyhyitä merkintöjä, jotka säilyttävät taustan, päätöksen, tilan ja seuraukset sekä korvatut päätökset viittauksella uuteen valintaan. Lähde on linkitetty alla. Esimerkkimme soveltaa tätä kevyttä ajatusta Jiran toimituspäätökseen.

Anna päätökselle selkeä paikka

Valitse Jira-tehtävä, joka parhaiten edustaa valinnan vaikutuspiirissä olevaa työtä. Tässä esimerkissä tiimi käyttää asiakasportaalin ilmoituksia koordinoivaa tehtävää. Se ohjaa lukijan jo toteutus- ja testityöhön.

Kerro tiimille merkinnän sijainti. Power Packin Decision Log kuuluu tehtävään, joten luo yksinkertainen tapa löytää se. Koordinointitehtävän merkintä voi kertoa ilmoituspäätösten olevan siellä. Jos tiimi pitää erillistä projektihakemistoa, lisää tehtävä sinne normaalilla tavalla.

Älä levitä kopioita useisiin tehtäviin ja odota niiden pysyvän yhdenmukaisina. Muut tehtävät voivat ohjata lukijat valittuun paikkaan. Vientikopiot auttavat keskustelussa, mutta tiimin pitää tietää, mistä ajantasainen kanta tarkistetaan.

Kirjoita tausta ennen johtopäätöstä

Tausta selittää, miksi kysymys on olemassa. Erota tosiasiat, rajoitteet ja oletukset, jotta tuleva lukija näkee muuttuneen osan.

Portaalitiimi kirjoittaa: ”Asiakkaiden täytyy tietää, kun tukipyyntö muuttuu merkityksellisesti. Nykyinen palvelu lähettää jo sähköpostia. Portaalin ensimmäinen julkaisu ei sisällä postilaatikkoa. Odotamme useimmille pyynnöille vain muutamaa asiakkaalle näkyvää tilamuutosta, mutta emme ole vielä mitanneet ilmoitusmääriä julkaisun jälkeen.”

Kappale on hyödyllisempi kuin ”sähköposti on yksinkertaisin vaihtoehto”. Se selittää lähtötilanteen ja tekee oletuksen näkyväksi. Se ei myöskään väitä sähköpostin olevan aina oikea kanava.

Lisää tarvittaessa viitteitä tukevaan selvitykseen. Jos tekninen kokeilu vaikutti valintaan, nimeä sen havainnot sisältävä Jira-tehtävä. Jos asiakaspalaute on tärkeää, tiivistä olennainen havainto kopioimatta yksityisiä tietoja tarpeettomasti päätökseen.

Taustan pitäisi auttaa uutta kollegaa ymmärtämään tilanne rekonstruoimatta kokonaista kokousta. Säilytä valintaan vaikuttavat yksityiskohdat ja jätä muu keskustelu alkuperäiseen paikkaansa.

Vertaa todellisia vaihtoehtoja

Hyödyllinen merkintä näyttää, mitä tiimi olisi voinut tehdä. Sisällytä vakavasti harkitut vaihtoehdot ja jokaiselle rehellinen etu ja haitta.

Nämä ovat kuvitteellisen järjestelmän esimerkkiarvioita. Toisella tiimillä voi jo olla postilaatikko tai koostepalvelu, jolloin vertailu muuttuu täysin. Hyvä päätösteksti tekee tämän taustariippuvuuden näkyväksi.

Älä heikennä hylättyjä vaihtoehtoja saadaksesi valitun näyttämään väistämättömältä. Koosteella on todellinen etu: vähemmän erillisiä viestejä. Tiimi jättää sen tästä julkaisusta pois, koska ajoitus ja toteutuksen laajuus painavat nykyisillä oletuksilla enemmän.

Erota myös vaihtoehto erillisestä päätöksestä. Asiakkaan koko viestin näyttäminen sähköpostissa voi vaatia oman tarkistuksensa. Kaikkien ilmoituskysymysten kokoaminen yhteen merkintään vaikeuttaa sovitun asian ymmärtämistä.

Kerro valinta ja seuraukset

Kirjoita päätös kokonaisena lauseena: ”Portaalin ensimmäisessä julkaisussa lähetämme sähköpostin, kun tukipyynnössä tapahtuu merkittävä asiakkaalle näkyvä tilamuutos. Sisäiset muokkaukset eivät laukaise viestiä.”

Selitä sitten syy: ”Tämä käyttää olemassa olevaa toimituskanavaa ja antaa asiakkaille nopeat edistymispäivitykset pitäen julkaisun rajauksen hallittavana.” Lause kuvaa tämän esimerkin perustelua; se ei väitä sähköpostin olevan yleisesti halvempi tai luotettavampi.

Seuraukset ansaitsevat yhtä paljon huomiota. Tiimi tarvitsee yhteisen määritelmän merkittävälle muutokselle. Testien on katettava toistuvat päivitykset ja kaksoisviestien käsittely. Tuen täytyy selittää viestejä synnyttävät tapahtumat. Asiakkaat, joilla on vilkkaita pyyntöjä, voivat edelleen saada haluamaansa enemmän sähköpostia.

Hyödyllinen seuraus johtaa luontevasti jatkotyöhön. Kirjaa vaikutus tähän ja hallitse tehtävää Jirassa. Päätösmerkinnän pitäisi auttaa löytämään työn tarpeen syy muuttumatta toiseksi työjonoksi kilpailevine tiloineen ja vastuineen.

Luo merkintä Power Packissa

Avaa Power Pack oikeassa Jira-tehtävässä ja käytä Decision Log (ADR Lite) -työkalua. Lisää merkintä otsikolla, joka nimeää todellisen valinnan, kuten ”Käytä välitöntä sähköpostia portaalin tavallisiin tilapäivityksiin”.

Valitse tiimin käyttöön sopiva luokka ja aloita Proposed-tilasta asian ollessa vielä keskustelussa. Lisää päätöksentekijä ja valinnan synnyttyä päätöspäivä. Päätöksentekijäkenttä kirjaa, kuka vastaa valinnasta; nimen syöttäminen ei suorita hyväksyntäprosessia puolestasi.

Täytä tausta, lisää vaihtoehdot etuineen ja haittoineen, valitse valittu vaihtoehto ja kirjoita seuraukset. Pidä sisältö ymmärrettävänä henkilölle, joka ei osallistunut keskusteluun.

Lisää vaikutuspiirissä olevat Jira-avaimet tarvittaessa. Muokkain hyväksyy pilkuilla erotetut tehtäväviitteet, joilla voi nimetä päätöksen koskemat toteutus- ja testitehtävät. Pidä niitä kirjattuina viitteinä; käytä Jiran tavallista linkitystä erikseen, jos tarvitset tehtäväsuhteen.

Tarkista valmis merkintä osallistujien kanssa. Varmista valitun vaihtoehdon ja kirjallisen selityksen vastaavuus. Tarkista tallennustila ennen kuin pyydät kollegoita luottamaan uusimpaan versioon, etenkin työkalun näyttäessä paikallista tai offline-tilaa.

Tee nykyinen kanta selväksi tilan avulla

Power Pack tarjoaa tilat Proposed, Accepted, Rejected ja Superseded. Sovi tiimin käyttötapa, jotta lukija erottaa päätöstä odottavan idean toteutusta jo ohjaavasta valinnasta.

Kun tuoteomistaja Maya tekee ilmoituspäätöksen, tiimi kirjaa päivän ja merkitsee kohdan Accepted-tilaan. Tila kuvaa päätöksen asemaa. Se ei todista toteutuksen valmistumista, testien läpäisyä tai julkaisulupaa.

Sama ero koskee Rejected-tilaa. Jos ehdotusta ei hyväksytä, lyhyt selitys voi säästää seuraavan henkilön toistamasta selvitystä tietämättä sen jo tapahtuneen. Säilytä hyödylliset perusteet, vaikka toteutustehtävää ei seuraa.

Palaa päätökseen oletusten muuttuessa

Kuvittele portaalin laajenevan julkaisun jälkeen asiakkaisiin, joilla on paljon aktiivisia pyyntöjä. Tuki kertoo joidenkin saavan useita tavallisia sähköposteja päivässä. Tämä on uutta taustatietoa, joka liittyy suoraan alkuperäiseen pienen viestimäärän oletukseen.

Tiimi avaa vanhan merkinnän ennen muutosehdotusta. Se voi nyt erottaa aiemmin järkevän kompromissin tuotteen tämän päivän kysymyksestä. Nykyinen päätös selittää välittömän sähköpostin valinnan; se ei kiellä parempaa lähestymistapaa muuttuneissa oloissa.

Luo uusi Proposed-merkintä päivittäiselle koosteelle. Power Pack voi kopioida merkinnän Proposed-tilaiseksi lähtökohdaksi. Tarkista jokainen kopioitu kenttä huolellisesti: vanhat oletukset, päivämäärät ja seuraukset eivät ehkä enää päde.

Kun uusi valinta hyväksytään, merkitse aiempi kohta Superseded-tilaan ja viittaa korvaavaan päätökseen korvauskentässä. Säilytä alkuperäinen perustelu luettavana sen sijaan, että kirjoittaisit sen uudelleen kuin tiimi olisi aina aikonut käyttää koostetta.

Tämä on tiimin dokumentointikäytäntö. Merkinnät pysyvät muokattavina, joten sovi korvaavien merkintöjen luomisesta olennaisiin muutoksiin ja tavallisten muokkausten varaamisesta korjauksiin tai selvennyksiin. Älä pidä lokia muuttumattomana auditointiketjuna.

Tee merkinnästä hyödyllinen arjessa

Käytä lokia uuden henkilön liittyessä tiimiin, jonkun ehdottaessa uudistusta tai kysyessä tehtävän erikoisen vaatimuksen syytä. Haku ja suodatus auttavat löytämään merkinnän tehtävän lokista. Power Pack voi myös viedä ADR-tyylistä Markdownia arviointiin tai muuhun dokumentointityönkulkuun.

Tarkista ennen viennin jakamista, että se vastaa nykyistä merkintää, ja nimeä tehtävä, jossa tiimi ylläpitää sitä. Ladattu dokumentti on tilannekuva; myöhemmät tehtävämuutokset eivät päivitä jo muualle lähetettyä kopiota.

Aloita yhdestä tiimin äskettäisestä päätöksestä, johon todennäköisesti palataan. Kirjoita tausta, todelliset vaihtoehdot, valittu lähestymistapa ja seuraukset. Sijoita merkintä Jira-työn viereen Power Packiin ja pyydä keskustelun väliin jättänyttä kollegaa lukemaan se. Jos hän pystyy selittämään valinnan järkevyyden ja sen muuttamista puoltavat olosuhteet, loki tekee hyödyllistä työtä.

• Michael Nygard: arkkitehtuuripäätösten dokumentointi