Spring til indhold

Har skrevet 50.000 ord omfattende softwaredokumentation med Markdown i GitHub, Craft og Confluence og derved sikret fastholdelse af viden og gennemsigtighed i processen.

Product Owner og projektudviklingschef

Situation. Det meste af det, der betød noget om produktet, og om hvordan teamet arbejdede, lå i folks hoveder. Det går fint lige indtil nogen ny kommer til, eller nogen forlader firmaet — og så sneglede onboardingen sig af sted, og en klump institutionel hukommelse var én opsigelse fra at være væk for altid.

Opgave. Målet var at få den viden ud af hovederne og ind i dokumentation, folk faktisk ville beholde og bruge: klar nok til at blive læst, struktureret nok til at blive vedligeholdt frem for droppet efter en måned.

Handling. En stor del af den blev skrevet i hånden, omkring 50.000 ord til sidst, i Markdown på tværs af GitHub, Craft og Confluence alt efter hvor hvert stykke hørte til. Den dækkede arkitekturen, processerne og det praktiske how‑to‑materiale — de spørgsmål, folk blev ved med at stille. Den blev holdt versionsstyret og, mindst lige så vigtigt, mulig at finde, for dokumentation, ingen kan lokalisere, kan lige så godt ikke eksistere.

Resultat. Videnen holdt op med at være skrøbelig. Nye folk kom hurtigere op i tempo, processen blev noget, man kunne pege på i stedet for at rekonstruere efter hukommelsen, og det hele blev reviderbart: man kunne se hvordan og hvorfor arbejdet blev gjort frem for at tage det på tro.