{"canonical_url":"https://engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/","content_markdown":"# Skrev 50 000 ord programvaredokumentasjon\n\nSkrev 50 000 ord grundig programvaredokumentasjon i Markdown i GitHub, Craft og Confluence, og sikret dermed at kunnskapen ble bevart og prosessen gjennomsiktig.\n\n2022 – 2024\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n---\n\n- Rolle: Produkteier og prosjektutviklingsleder\n- Kategorier: [Teamledelse](https://advisory.engineer.company/nb/categories/team-leadership/), [Teknisk ledelse](https://advisory.engineer.company/nb/categories/technical-leadership/), [Mentorarbeid og coaching](https://advisory.engineer.company/nb/categories/mentoring/), [Dokumentasjon](https://advisory.engineer.company/nb/categories/documentation/)\n- Tjenester: [Teknisk ledelse og rådgivning](https://advisory.engineer.company/nb/services/technical-leadership/), [Teknisk dokumentasjon](https://advisory.engineer.company/nb/services/technical-documentation/)\n\n\u003chttps://engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Skrev 50 000 ord programvaredokumentasjon i GitHub, Craft og Confluence og gjorde kunnskapen varig, transparent og etterprøvbar.","formats":{"gemtext":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/index.gmi","gopher":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/gophermap","html":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/","json":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/index.json","markdown":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/index.md","pdf":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/index.pdf"},"kind":"page","language":"nb","title":"Skrev 50 000 ord programvaredokumentasjon","url":"https://advisory.engineer.company/nb/portfolio/wrote-50000-words-of-software-documentation/","version":1}