navikt Klarspråk
Stram inn norsk prosa uten å endre beslutninger, kontrakter eller teknisk betydning.
Oppdag språkreglene først
Ikke anta at hele repositoryet bruker samme språk.
- Finn consumer-eide språkregler for den konkrete artefakttypen og pathen.
- Identifiser målgruppe, bokmål/nynorsk, tone og regler for domeneord, tekniske termer, kodeidentifikatorer og logger.
- Behandle eksisterende tekst som evidens bare når den er konsekvent; tilfeldig historikk er ikke automatisk en standard.
- Hvis en nødvendig språkregel mangler, spør brukeren. Ikke innfør en generell norsk/engelsk-policy gjennom en språkvask.
Bevar literals, API-felter, identifikatorer og etablerte domenetermer nøyaktig når en endring ville endre kontrakten.
Arbeidsflyt
- Avklar om oppgaven er ren språkvask eller også innholdsredigering.
- Marker fakta, beslutninger, normative krav og kodeord som ikke skal endres.
- Skriv om med kortere setninger, aktive verb og tydelig handling.
- Kontroller at tall, modalverb, negasjoner, vilkår og ansvar fortsatt betyr det samme.
- Vis vesentlige meningsnære valg hvis flere formuleringer er mulige.
Operative regler
- Start med utfallet eller handlingen leseren trenger.
- Hold ett hovedpoeng per setning.
- Bruk aktiv form og konkrete subjekter.
- Kutt gjentakelser, fyllord og kunstige oppsummeringer.
- Bruk tekniske termer etter consumerens policy. Hvis ingen policy finnes, spør før du oversetter eller fornorsker etablerte termer.
- Bruk bindestrek i norske sammensetninger med engelske fagtermer når det er naturlig.
- Fjern svulstige AI-markører og falsk symmetri uten å gjøre teksten monoton.
- Bruk Nav i løpende tekst når virksomheten omtales; bevar offisielle navn og kodeidentifikatorer som de er.
- Ikke ta med personopplysninger, tokens eller secrets i brukerrettede feilmeldinger eller eksempler.
Grenser
Alltid
- Bevar teknisk betydning og dokumentert artefaktform.
- Skill språklige forslag fra innholdsendringer.
- Følg den mest spesifikke consumer-eide språkregelen.
Spør først
- Omstrukturere et helt dokument.
- Endre terminologi som inngår i domene- eller API-kontrakter.
- Publisere, kommentere eksternt eller opprette PR/issue; vis mål og få eksplisitt godkjenning.
Aldri
- Gjette målform, språkvariant eller loggspråk.
- Endre en beslutning under dekke av språkvask.
- Erstatte et kodeord eller domeneterm bare fordi et norsk synonym finnes.