Start med et synlig mål

«Slik endrer du innstillingen» er en ufullstendig beskrivelse hvis leseren ikke vet hva som skal være annerledes etterpå. Et arbeidsnotat bør derfor starte med ønsket resultat, hvilken situasjon fremgangsmåten gjelder for, og hva som må være på plass før første steg.

I redaksjonens arbeidsmal skilles selve handlingen fra kontrollen etterpå. Det gjør det lettere å se forskjellen på en knapp som er trykket på, og en innstilling som faktisk er lagret. En beskrivelse av et menyvalg bør følges av hva leseren skal se når endringen er fullført.

Skriv ned hvor forklaringen kan slutte å passe

En veiledning kan være riktig for ett grensesnitt og misvisende for et annet. Før publisering er det derfor nyttig å fylle ut tre korte kontrollpunkter:

• Miljø: Hvilken tjeneste, enhet eller kontotype gjelder forklaringen for?
• Forutsetning: Hvilken tilgang eller innstilling trenger leseren allerede?
• Avvik: Hva skal leseren gjøre dersom menyen eller resultatet ser annerledes ut?

Poenget er ikke å fylle teksten med forbehold. Et konkret avvik kan gi et konkret alternativ: undersøk riktig hjelpeside hos tjenesten, finn hvilken versjon du bruker, eller stans før du gir fra deg opplysninger som fremgangsmåten ikke forklarer.

Et arbeidsark før guiden er ferdig

Vi bruker dette som en redaksjonell sjekkliste, ikke som et påstått resultat av en produktprøve:

1. Skriv spørsmålet guiden skal svare på i én setning.
2. Noter originalkilden som støtter hver tjenestespesifikke opplysning.
3. Les hvert steg sammen med det forventede resultatet.
4. Merk regneeksempler og andre konstruerte situasjoner tydelig.
5. Kontroller hele siden på mobil, inkludert tabeller og lenker.
6. Gjør det enkelt å sende en presis rettelse med lenke og beskrivelse.

To eksempler fra guidebiblioteket er Falsk SMS og phishing og Sikker betaling på nett. Temaene er forskjellige, men begge trenger et tydelig skille mellom forklaring, kildegrunnlag og leserens neste handling.

Spørsmål og rettelser kan sendes til info@midtpunktet.com. En samlet inngang til temaer og kontakt finnes også på Midtpunktets emneoversikt.