Miksi perinteiset tekniset dokumentit ovat niin kammottavia?

Olen varma, että melkein jokainen kehittäjä on törmännyt samaan ongelmaan: avaa uusi arkkitehtuuridokumentti ja huomaa silmien painuvan kiinni. Perinteinen tekninen dokumentaatio keskittyy usein siihen mitä järjestelmä tekee, mutta unohtaa kokonaan selittää miksi se ylipäätään on olemassa ja miten se toimii käytännössä.

Domain Storytelling muuttaa tämän kaiken.

Mitä Domain Storytelling oikeastaan on?

Kyseessä on yhteistyöpohjainen lähestymistapa, jossa tekninen tiimi, liiketoiminnan asiantuntijat ja sidosryhmät rakentavat yhdessä visuaalisen kuvan siitä, miten järjestelmä toimii. Kuvaat sen sijaan tarinoiden avulla, kuka tekee mitä, milloin ja miksi.

Ajattele sitä vuokaaviona, joka kertoo tarinaa.

Prosessissa tunnistetaan toimijat eli mukana olevat ihmiset ja järjestelmät, heidän tekemisensä ja kohteet, joita he käsittelevät. Nämä elementit yhdistetään visuaaliseksi ketjuksi, jonka ymmärtää kuka tahansa – olipa kyse sitten kehittäjästä tai myyntitiimin jäsenestä.

Miksi kehittäjien kannattaisi välittää?

Suurin osa teknologisesta velasta ei synny huonosta koodista. Se syntyy väärinymmärryksistä.

Rakennat jotain, jonka luulet sidosryhmän haluavan. He halusivatkin täysin eri asian. Ja yhtäkkiä refaktorointia tapahtuu keskellä yötä.

Domain Storytelling tarttuu tähän ongelmaan jo alkuvaiheessa. Kun näet liiketoimintaprosessin visuaalisesti kuvattuna, aukot, päällekkäisyydet ja väärinymmärrykset paljastuvat välittömästi.

Event-driven -arkkitehtuureissa tämä on erityisen tärkeää. Event-sourcin ytimenä on, miten hyvin järjestelmä mallintaa todellisen maailman toimintaa. Jos tarina menee pieleen alun perin, tulet viettämään kuukausia sovittamassa event-skeemaa jälkikäteen.

Käytännön hyödyt

Nopeampi perehdytys: Uudet tiimin jäsenet ymmärtävät järjestelmän tarkoituksen minuuteissa, ei päivissä.

Vähemmän uudelleentyöstöä: Kaikki sopivat siitä, mitä ollaan rakentamassa, ennen kuin yhtään koodiriviä kirjoitetaan.

Parantunut viestintä sidosryhmien kanssa: Ei-tekniset kumppanit voivat todella osallistua suunnittelukeskusteluihin merkityksellisesti.

Selkeämpi event-mallinnus: Event sourcing -maailmassa Domain Storytelling tekee aggregate-rajoista ja event-suhteista visuaalisesti ymmärrettäviä.

Miten pääset alkuun?

Et tarvitse kalliita työkaluja. Valkotaulu, post-it-lappuja ja halua kuunnella asiantuntijoita vievät jo pitkälle.

Käytännössä kysyt vain "mitä tapahtuu seuraavaksi?" kunnes olet kuvannut koko prosessin. Kiinnitä huomiota kohtiin, joissa ihmiset empivät, ovat eri mieltä tai sanovat "asia on monimutkaisempi" – ne hetket paljastavat todellisen monimutkaisuuden.

Yhteys omaan työhösi

Olipa kyse sitten yksinkertaisesta landing pagesta tai monimutkaisesta hajautetusta järjestelmästä, periaate pätee aina: kun ymmärrät teknisen ratkaisun takana olevan inhimillisen tarinan, lopputulos on parempi.

Domain-mallisi on yhtä hyvä kuin ymmärryksesi domainista itsestään. Domain Storytelling tarjoaa strukturoidun ja toistettavan tavan rakentaa tätä ymmärrystä yhdessä.

Seuraavan kerran kun suunnittelet uutta ominaisuutta tai järjestelmää, ohita pitkä vaatimusdokumentti. Napata huopakyniä. Kerro tarina ensin.

Oletko kokeillut Domain Storytellingia projekteissasi? Jaa kokemuksesi kommenteissa – kerro, mikä toimi ja mikä ei.