Dokumentasjon er markedsføring for mennesker og AI

Egil Fujikawa Nes

Google på skjerm

I denne artikkelen ser vi på dokumentasjon som et markedsføringsverktøy og hvordan man kan skrive nyttig dokumentasjon som promoterer teknologiprodukter for både mennesker og maskiner. 

Dokumentasjon blir ofte sett på som en plikt snarere enn en naturlig del av leveranseprosessen for både utviklere og produkteiere. En god dokumentasjon er viktig for å forstå hvordan et komplekst system fungerer, men det er sjelden at dokumentasjon blir verdsatt og fremmet slik den fortjener. 

Dokumentasjon er et kinderegg

Å skrive god dokumentasjon og gjøre den tilgjengelig gir mange fordeler, blant annet:

  • Øker produktets synlighet
  • Fremmer produktadopsjon
  • Reduserer behovet for support

Se for deg et praktisk eksempel. Et Google-søk på hvordan man fører regnskap for et julebord, gir en guide om hvordan dette kan gjøres i regnskapsprogrammet Fiken

Google søk om hvordan man bokfører julebord

Bruker man en AI-tjeneste som Perplexity, vil den også vise en banner med Fiken-dokumentasjonen over selve svaret. 

Hvordan bokføre julebord søk på Perplexity

Invester i kvalitetsdokumentasjon

Tradisjonelt sett er ikke utviklere spesielt glade i å skrive dokumentasjon. Det blir ofte sett på som et punkt på sjekklisten i "definition of done" når ny funksjonalitet skal utvikles.

Når dokumentasjonen er ferdig, blir den ofte glemt i et internt arkiv og tas kun frem igjen når en ny utvikler skal onboardes, eller når eksterne konsulenter gjennomfører en revisjon.

Ved å løfte dokumentasjon til samme status som selve funksjonaliteten, motiveres utviklere til å lage bedre dokumentasjon, samtidig som det gir en verdifull ressurs for markedsavdelingen.

For å sikre god dokumentasjon bør minst 10% av ressursene i et utviklingsprosjekt settes av til dokumentasjonsarbeid.

Lær av de beste

Stripe er kjent for sin eksepsjonelle dokumentasjon og er et godt eksempel på hvordan dokumentasjon bør skrives og vedlikeholdes.

Uten å ha innsikt i deres interne prosesser, er det trygt å anta at dokumentasjonen deres ikke bare er skrevet av utviklere og tekniske skribenter, men at det står et helt team bak for å sikre tilgjengelighet og relevans.

Noen viktige punkt fra Stripe og Fiken som enhver bedrift kan ta i bruk:

  • Sett brukeren i fokus
  • Hold det enkelt
  • Én oppgave per side
  • Bruk et klart og tydelig språk
  • Link til mer informasjon
  • Invester i visuelt design
  • La dokumentasjonen vise frem produktet ditt

Når utviklere deltar i dokumentasjonsprosessen, får de samtidig mulighet til å se produktet sitt gjennom brukerens øyne.

Det er lett å få tunnelsyn når man jobber med en funksjon, og dokumentasjonsarbeidet gir en verdifull mulighet til å oppdage problemstillinger man kanskje ikke så under utviklingen.

AI er kraftig - men avhengig av data for å lære

Det er mye som er skrevet om hvordan fremtidens brukere i stor grad vil være maskiner, og hvordan AI begrenser adopsjonen av ny teknologi.

I en stadig mer AI-drevet verden er dokumentasjon ikke lenger bare for brukerne. AI-agenter skanner og analyserer kontinuerlig innhold på nettet. Velstrukturert og omfattende dokumentasjon gir verdifull treningsdata for AI-modeller, noe som gjør produktet ditt lettere å forstå og mer tilgjengelig for disse systemene.

Denne økte forståelsen gir direkte utslag i bedre synlighet i søkemotorer, mer relevante AI-genererte anbefalinger og økt produktkjennskap.

AI er kraftig, men avhengig av data for å lære. Når nye funksjoner introduseres, kan AI-verktøy være trege med å fange dem opp på grunn av begrenset treningsdata. Ingen har enda brukt funksjonen, og dermed vil ofte AI mangle nødvendig informasjon.

Detaljert dokumentasjon fungerer som en pålitelig informasjonskilde for både mennesker og AI-systemer, noe som gjør det enklere for AI-verktøy å integrere de nye funksjonene i sine anbefalingsmodeller.

Vil du lære mer? Ta kontakt. 

Kontakt oss

  • Steinar b&w

    Steinar Magnussen

    Leder salg

    +47 957 31 083

Les mer

  • 99x logo i vinduskarmen på kontoret

    Slik bygger du AI-agenter som løser arbeidsoppgaver

    Har du noen gang ønsket deg en utrettelig kollega som kan håndtere de kjedelige, repeterende oppgavene, ta smarte beslutninger og gi deg tid til å fokusere på de store idéene? Velkommen til AI-agentenes verden! I denne artikkelen skal vi utforske hvordan AI-agenter kan designes og hvordan de kan forvandle arbeidsflyter ved å utføre virkelige oppgaver.

    Les merLes mer
  • utviklingsrammeverk

    5 ting du må vurdere når du skal velge et utviklingsrammeverk

    Valget av utviklingsrammeverk kan være avgjørende for produktet ditt - ikke bare i dag, men i årene som kommer.

    Les merLes mer