klarsprak

Klarspråk

Redigér norsk bokmål så teksten blir klar, korrekt og menneskelig. Målgruppa er typisk utviklere, driftere og arkitekter, men prinsippene gjelder all norsk sakprosa.

Språkloven pålegger offentlige organer å bruke klart, korrekt språk tilpassa mottakerne. Følg Språkrådets klarspråk-prinsipper og ISO 24495-1.

Arbeidsflyt

1. Les hele teksten først.
2. Skann etter mønstrene under: AI-markører, substantivsyke, anglisismer, feiloversatte fagtermer, nynorsk/svensk-innblanding, dårlig struktur.
3. Skriv om. Bevar meningen og faglig innhold: endre bare språk, form og struktur.
4. Selvrevisjon: «Hva avslører at dette er KI-generert?» Fiks det som gjenstår.
5. Tilpass til teksttypen (ADR, README, UI-tekst, blogg).

Klarspråk-prinsipper

Det viktigste først

Start med konklusjonen eller det leseren trenger å vite. Bakgrunn kommer etterpå.

❌ Etter en grundig evaluering av flere alternativer, der vi vurderte
   både ytelse, driftskompleksitet og kostnad, har vi besluttet å
   gå videre med CNPG som Postgres-operator.

✅ Vi bruker CNPG som Postgres-operator. Den gir oss automatisk
   failover, backup og oppgradering uten nedetid.

Skriv for leseren

Tenk: Hva trenger leseren å gjøre etter å ha lest dette? Kutt alt som ikke hjelper dem. Ikke definer ting målgruppa allerede vet.

Unngå substantivsyke

Bruk verb, ikke substantiv laget av verb. Typisk mønster: -ing + av.

❌ Vi foretar en gjennomgang av implementasjonen.
✅ Vi gjennomgår implementasjonen.

❌ Gjennomføring av migrering til ny plattform.
✅ Vi migrerer til ny plattform.

Kort over langt

• Kort setning over lang. Én idé per setning — må leseren lese setningen to ganger, del den i to.
• Vanlig ord over fint ord: «bruke» ikke «benytte», «hjelpe» ikke «fasilitere», «mange» ikke «tallrike», «hvis» ikke «i det tilfellet at».
• Aktiv form over passiv: «vi bruker» ikke «det benyttes». Fang «blir/ble + partisipp» og navngi aktøren: «spørringer valideres» → «kompilatoren validerer spørringer». Passiv er greit bare når aktøren er ukjent eller uvesentlig.
• Konkret over abstrakt: «vi bygger nytt image» ikke «det kreves en tilpasning av image-artefaktet».
• Kutt fyllord: «i bunn og grunn», «i stor grad», «på mange måter», «det er viktig å merke seg at».
• Kutt adverb, eller bruk et sterkere verb: «kjører raskt» → «er rask» eller tallet. «forbedrer betydelig» → den målte forskjellen.
• Si hva ting gjør, ikke hvordan det føles. «SQL du kan lese» og «databasen er alltid nær» navngir en følelse. Skriv heller mekanismen eller tallet: «.toSQL() returnerer strengen som sendes til databasen». Kan setningen stå uendret i dokumentasjonen til et helt annet prosjekt, sier den ingenting om dette — kutt den.