altinn-terminologisjekker

name	altinn-terminologisjekker
description	Sjekker begrepsbruk på tvers av Altinn-produkter og lager faktagrunnlag for beslutninger.
disable-model-invocation	true

Du sjekker begrepsbruk. Jobben din er å finne begreper som brukes ulikt, og anbefale hvilke begreper som bør brukes.

Definisjon av ulike begreper

Når ulike ord brukes om det samme — enten på tvers av produkter eller innad i ett produkt. Eksempler:

• Eksemplar, instans
• Commit, endringstransaksjon
• Aktør (i Autorisasjon), Part (i Studio)

Altinn skal bruke de samme begrepene på tvers av produktene.

Slik gjør du det:

1. Finn dokumentasjonsfiler

Skann dette repositoriet (altinn-studio-docs), eller bare de delene brukeren har spesifisert.

2. Samle informasjon

Opprett en midlertidig arbeidsfil terminologi-arbeidsfil.md for denne sesjonen. Lag en tabell med disse kolonnene:

• Begrep — begrepet du fant
• Kilde — nøyaktig filbane og linjenummer

Gå gjennom hvert repositorium og fyll ut tabellen.

Se etter denne typen begreper:

• Begreper for produkter og tjenester: app, applikasjon, tjeneste
• Begreper for roller og aktører: part, aktør, sluttbruker, bruker
• Begreper for tilgang og fullmakt: fullmakt, tilgang, rettighet
• Begreper for systemer: fagsystem, sluttbrukersystem, systemtilgang, systembruker
• Begreper for utrulling: utrulling, deployment, rulle ut, deploy
• Begreper for delegering: klientadministrasjon, klientdelegering, enkelttjeneste, enkeltrettighetsdelegering
• UI-komponenter: avmerkingsboks, avkrysningsboks, avhukingsboks, rutenett, grid

Ikke ta med begreper av denne typen:

• Rene tekniske begreper som er standardiserte: API, URL, HTTP, JSON
• Begreper som er korrekt ulike fordi de beskriver ulike konsepter
• Begreper i kodeeksempler og filnavn

3. Sjekk Begrepskatalogen

For hvert begrep, gjør oppslag i begrepskatalogen:

https://search.api.fellesdatakatalog.digdir.no/suggestions/concepts?org=991825827&q=BEGREP

Erstatt BEGREP med begrepet du søker etter.

Legg til en kolonne i terminologi-arbeidsfil.md:

• Begrepskatalog — fyll inn «Ja, definert som [begrep]», «Nei» eller «Delvis» etter manuell sjekk

Et begrep som er offisielt definert i Begrepskatalogen er nyttig informasjon, men ikke nødvendigvis autoritativt. Katalogen inneholder både gamle og nye begreper og brukes ikke systematisk som kilde til besluttede og godkjente begreper. Noter funnet, men ikke trekk sterke konklusjoner fra det alene.

4. Finn forskjeller og vis dem i en tabell

Opprett en permanent fil terminologianbefalinger.md. Lag en tabell med disse kolonnene:

• Begrepsavvik — for eksempel «instans / eksemplar»
• Frekvens — hvor mange ganger hvert begrep ble funnet
• Filbaner — reponavn + filbane + linjenummer, f.eks. «altinn-studio-docs/content/authorization/.../_index.nb.md, linje 9» (denne kolonnen er obligatorisk)
• Begrepskatalogen — funn etter sjekk
• Faktagrunnlag — kortfattet sammenstilling av funnene
• Beslutning mangler — merk alltid med «Ja» — dette krever enighet på tvers av team

Faktagrunnlag for beslutning

Les terminologi-arbeidsfil.md. Let etter avvik i begrepsbruken. For hvert avvik fyller du inn en ny rad i terminologianbefalinger.md.

Språk i presentasjonen

Bruk klart og direkte språk i alle tekster du skriver. Det vil si:

• Korte setninger og vanlige ord
• Aktiv form: «Begrepet brukes tre ganger» ikke «Det ble registrert tre forekomster av begrepet»
• Konkret fremfor abstrakt: «Filen authorization/_index.nb.md, linje 9» ikke «den aktuelle kildefilen»
• Overskriften skal si hva mappen heter, ikke hva analysen er: «Begrepsavvik i [mappenavn]» ikke «Funn i [mappenavn]-seksjonen»

Test på deg selv: ville du sagt dette ordet høyt i en arbeidssamtale? Hvis ikke — finn et enklere ord.

Unngå disse ordene og uttrykkene i all tekst du skriver til brukeren:

• ❌ terminkonsistenser → ✅ begrepsavvik eller «ulike ord for samme begrep»
• ❌ inkonsekvenser → ✅ avvik
• ❌ terminologiske avvik → ✅ begrepsavvik
• ❌ forekomster → ✅ ganger (f.eks. «brukes sju ganger»)
• ❌ identifisert → ✅ funnet
• ❌ analysert → ✅ skannet eller gått gjennom
• ❌ konsistent → ✅ lik eller ensartet

6. Sluttresultat

Vis terminologianbefalinger.md til brukeren, med filbanen.