Språk
Retningslinjene skal sørge for at vi får et ensrettet språk og forståelig innhold i tjenestene som lages i Altinn.
Som hovedregel bør du bruke retningslinjene fra Språkrådet når du skriver. I tillegg har vi definert noen mer spesifikke regler for Altinn som vi anbefaler at du følger.
Vi oppfordrer til at du skriver innholdet i tjenestene dine på både bokmål, nynorsk og engelsk.
Generelle anbefalinger
- Bruk et muntlig og lett språk
- Skriv direkte til brukeren (bruk «du»)
- Forklar hva som er neste steg
- Skriv kort, klart og klikkbart
- Skriv tekster som kan skummes
- Vær spesifikk om innholdet, men sørg samtidig for å bruke ord som alle kan forstå
Unngå:
- lange ord
- lange setninger
- kryptiske eller lyriske overskrifter
- flere poenger i samme setning
- flere poenger i samme avsnitt
- VERSALER (store bokstaver)
Lengde på tekst:
- overskrifter: maks. 8 ord
- setninger: 15-20 ord
- avsnitt: 40-80 ord
Skriv rett frem
Formelt språk er ofte skrudd sammen slik at utsagnet (verbet) kommer sent i setningen. Det gjør at man må lese mange ord før man får verbet. Det krever mer av leseren som må huske hva som stod tidlig i setningen. Verbet bør stå så tidlig som mulig i setningen og bør stå så nært subjektet som mulig.
Eksempel:
Arbeidstaker har en del plikter som må oppfylles →
Arbeidstaker må oppfylle en del plikter
Unngå verbalsubstantiver
Verbalsubstantiver gjør teksten unødvendig tung å lese. Et verbalsubstantiv er et substantiv dannet av et verb, for eksempel at «å utrede» blir til «å foreta en utredning», der utredning er selve verbalsubstantivet. De fleste verbalsubstantiv slutter på «-ing» og «-else».
En tekst med mange verbalsubstantiver blir abstrakt fordi den fjerner seg fra de konkrete handlingene den egentlig beskriver. Teksten blir mer konkret når vi bruker verbene i stedet.
Eksempler:
- Ved avtaleinngåelsen → Da avtalen ble inngått
- Ny henvendelse → Kontakt oss
- Innmelding av feil → Meld inn feil
Skriv aktivt, ikke passivt:
I lovspråk blir det ofte skrevet at noe skal gjøres og det er ikke ønskelig å si noe om hvem som skal gjøre det. I Altinn sine løsninger vil det gjerne være flere enn en person som skal gjøre noe, men vi kan skrive direkte til brukeren likevel.
Eksempel:
Forberedelser og planleggingsaktiviteter må gjennomføres før utviklingen av tjenesten(e) kan og bør starte →
Gjør forberedelser og planlegg godt før du utvikler tjenesten.
Oppdeling av tall
Riktig og konsekvent oppdeling av tallene hjelper brukeren å lese og skille forskjellige typer nummer. Ingen av nummerne skal skilles med punktum, kun mellomrom. I felt hvor brukeren skal skrive inn lengre nummer er det hjelpsomt å indikere antall siffer.
- Organisasjonsnummer deles opp i tre og tre: 123 456 789
- Bankkonto deles opp i fire, to og fem: 1234 56 78901
- Personnummer deles opp i seks og fem: 123456 78901
- Mobilnummer deles opp i tre, to og tre: 987 65 432
- Fasttelefon og faks deles opp i to og to: 98 76 54 32
Tid og dato
- Klokkeslett skriver vi kun med timer og minutter, aldri sekunder. Klokkeslett skrives slik: 13:45
- Dato skal som hovedregel skrives slik: 05.06.2017
- Unntaksvis kan datoer skrives slik i løpende tekst: 5. juni 2017