Hvorfor dine arkitekturdokumenter gør alle trætte (og hvad du kan gøre ved det)

Lad os være ærlige: hvornår har du sidst læst en teknisk dokumentation, der ikke fik dig til at lukke fanen og falde i søvn? Den slags papir bruges ofte mest som sleep aid.

Det behøver ikke være sådan.

Domain Storytelling – hvad handler det om?

Domain Storytelling er en samarbejdsmetode, hvor udviklere, eksperter fra forretningen og interessenter sammen kortlægger, hvordan et system fungerer. Men i stedet for kedelige UML-diagrammer eller tykke specifikationer bruger man historier.

Tænk på det som et flowchart, der læser som et uddrag fra en helt almindelig arbejdsdag.

Du starter med at finde aktørerne – de mennesker og systemer, der er involveret. Så identificerer du deres aktiviteter: hvad de faktisk gør. Og til sidst arbejdsemnerne – de ting, der bliver oprettet, ændret eller brugt. Alt dette flettes sammen til en visuel sekvens, som både udviklere og ikke-teknikere kan forstå.

Hvorfor skal du som udvikler overhovedet interessere dig for det?

De fleste tekniske problemer opstår ikke, fordi koden er dårlig. De opstår, fordi der er uoverensstemmelse mellem det, du byggede, og det, kunden faktisk havde brug for.

Domain Storytelling fanger denne uoverensstemmelse tidligt. Når du kan se forretningsprocessen visualieret foran dig, bliver huller, dobbeltarbejde og misforståelser med det samme tydelige.

For event-drevne systemer er dette særligt vigtigt. En event-sourced arkitektur lever og dør af, hvor godt den fanger den virkelige adfærd i domænet. Får du historien forkert, ender du med at bruge måneder på at rette dit event schema bagefter.

De praktiske fordele

Hurtigere introduktion af nye teammedlemmer: De forstår systemets formål på minutter i stedet for dage.

Mindre omarbejde: Alle er enige om "hvad" før nogen overhovedet skriver kode.

Bedre kommunikation med interessenter: Ikke-tekniske samarbejdspartnere kan faktisk bidrage meningsfuldt til planlægningsmøder.

Klarere event-modellering: For dem der arbejder med event sourcing, gør Domain Storytelling aggregate-grænser og event-relationer visuelt intuitive.

Sådan kommer du i gang

Du behøver ikke fancy værktøjer. En whiteboard, nogle post-it-sedler og villighed til at lytte til domæneeksperter er nok til at komme langt.

Den grundlæggende øvelse er enkel: stil spørgsmålet "hvad sker der derefter?" indtil du har kortlagt en hel forretningsproces. Læg mærke til, hvor folk tøver, er uenige eller siger "det er faktisk mere kompliceret end som så" – de øjeblikke afslører den virkelige kompleksitet i dit domæne.

Det handler om din stack

Uanset om du bygger en simpel landingsside eller et komplekst distribueret system på din cloud hosting-platform, holder princippet: at forstå den menneskelige historie bag din tekniske løsning fører til bedre resultater.

Din domænemodel er kun så god som din forståelse af domænet selv. Domain Storytelling giver dig en struktureret, gentagelig måde at opbygge den forståelse på i fællesskab.

Næste gang du planlægger en ny funktion eller et nyt system – spring den lange kravspecifikation over. Tag nogle tuschpenne frem. Fortæl historien først.

Har du prøvet Domain Storytelling i dine projekter? Del dine erfaringer i kommentarerne – vi vil gerne høre, hvad der har virket (og hvad der ikke har) for dit team.