Preview: Dette er dokumentasjonen for Altinn Studio v9, som er en forhåndsversjon. Gjeldende versjon er v8.
For å se dokumentasjonen for gjeldende versjon, velg v8 i versjonsvelgeren i menyen til venstre.
Stil og tone
Slik skriver du personlig, vennlig og tydelig til brukerne.
Slik skriver du personlig, varmt og vennlig
- Skriv som om du snakker direkte til brukerne (bruk «du» og «vi»).
- Brukeren skal møte et språk som er tydelig, informativt og vennlig.
Slik skriver du ubyråkratisk
- Bruk enkle, korte ord som alle forstår. Unngå faguttrykk og fremmedord.
- ❌ Vanskelig: «Orkestrere datautvekslingen mellom systemene»
- ✅ Enkelt: «Styre datautvekslingen mellom systemene»
- Bruk korte setninger. Unngå lange, innviklede setninger med mange leddsetninger.
- Skriv på et nivå som passer for en 12-åring. Dette gjør teksten lettere å forstå for alle.
- Bruk verb fremfor substantiver (unngå «substantivsjuke»).
- ❌ Substantiv: «Gjennomføring av testing»
- ✅ Verb: «Test tjenesten»
- Skriv verbene så tidlig som mulig i setningen.
- Bruk ord og vendinger som folk bruker i dagligtale, men vær fortsatt presis og tydelig.
Slik skriver du tydelig
- Pek på konkrete handlinger, og unngå abstrakt språk.
- ❌ Abstrakt: «Optimaliser brukeropplevelsen»
- ✅ Konkret: «Legg til tydelige feilmeldinger»
- Bruk kulepunkter for å dele opp den viktigste informasjonen.
- Skriv helst titler og mellomtitler som er hele setninger, slik at leserne lett forstår hva som kommer.
- ❌ Vagt: «Planlegg datamodellen»
- ✅ Tydelig: «Planlegg datamodellen før du bygger skjemaet»
- Unngå metaforer og innforstått jargong.
- ❌ Metafor: «Dykk ned i datamodellen»
- ✅ Tydelig: «Åpne datamodellen»
Lengde på tekst
Bruk disse tommelfingerreglene:
- Overskrifter: Ikke mer enn åtte ord.
- Setninger: Helst under 25 ord.
- Avsnitt: To til fire setninger.