# Skrev 50 000 ord grundig programvaredokumentasjon i Markdown i GitHub, Craft og Confluence, og sikret dermed at kunnskapen ble bevart og prosessen gjennomsiktig.

2022 – 2024

**Situasjon.** Det meste som betydde noe om produktet og om hvordan teamet jobbet, satt i hodene på folk. Det går fint helt til noen nye begynner, eller noen slutter — og da går onboardingen i sneglefart, og en god del av organisasjonens hukommelse er én oppsigelse unna å forsvinne for godt.

**Oppgave.** Målet var å få den kunnskapen ut av hodene og inn i dokumentasjon som folk faktisk ville ta vare på og bruke: tydelig nok til å bli lest, strukturert nok til å bli vedlikeholdt i stedet for å bli lagt bort etter en måned.

**Handling.** Mye av den ble skrevet for hånd, rundt 50 000 ord til slutt, i Markdown fordelt på GitHub, Craft og Confluence etter hvor hver del hørte hjemme. Den dekket arkitekturen, prosessene og det praktiske veiledningsstoffet — spørsmålene folk stadig stilte. Den ble holdt under versjonskontroll og, like viktig, var lett å finne, fordi dokumentasjon som ingen finner, like gjerne kunne vært uskrevet.

**Resultat.** Kunnskapen sluttet å være sårbar. Nye folk kom raskere i gang, prosessen ble noe man kunne peke på i stedet for å rekonstruere fra hukommelsen, og det hele ble etterprøvbart: man kunne se hvordan og hvorfor arbeidet ble gjort, i stedet for å ta det på tro.

---

- Rolle: Produkteier og prosjektutviklingsleder
- Kategorier: [Teamledelse](https://engineer.company/nb/categories/team-leadership/), [Teknisk ledelse](https://engineer.company/nb/categories/technical-leadership/), [Mentorarbeid og coaching](https://engineer.company/nb/categories/mentoring/), [Dokumentasjon](https://engineer.company/nb/categories/documentation/)
- Tjenester: [Teknisk ledelse og rådgivning](https://engineer.company/nb/services/technical-leadership/), [Teknisk dokumentasjon](https://engineer.company/nb/services/technical-documentation/)

<https://engineer.company/nb/portfolio/wrote-50-000-words-of-comprehensive-software-documentation-30/>
