Skip to main content

Begrepskatalog

Begrepskatalogen inneholder definisjoner av begreper som brukes i og understøttes av de studieadministrative tjenestene.

Formålet med denne katalogen er å skape felles kontekst for og forståelse av begreper i våre løsninger. Det vil bidra til at de samme begrepene brukes likt i brukerflater, APIer, dokumentasjon og datamodell. Slik unngår vi forvirring for interne utviklingsteam, eksterne utviklingsteam og for virksomheter og brukere som benytter seg av våre produkt.

Hvert begrep i katalogen er markert enten som "aktiv" eller "utkast" på denne måten, her med forklaring av markeringene:

aktiv

Anses som "klart til bruk". Definisjon av begrepene med denne statusen er enten validert av sektorbrukere eller uendret fra eksisterende bruk av begrepet i våre produkter.

utkast

Foreslått begrep og definisjon. Begrepet er ikke validert av sektorbrukere.

Prinsipper for valg av begreper​

  • Begreper bør korrespondere med vanlig norsk språkbruk
  • Begreper bør følge sjargongen i utdanningssektoren (studieadministrativ fagterminologi)
  • Ett begrep for én ting
  • Tekniske termer (f.eks. datastrukturtermer) kan velges der det er et særlig behov for presisjon, og det ikke finnes et eksisterende etablert begrep for konseptet begreper beskriver.

Hvordan bidra til katalogen​

Alle kan medvirke til utviklingen av katalogen. Arbeidsprosessen vi legger opp til baserer seg på at produktområde Studieadministrasjon har det redaksjonelle ansvaret.

Vi tar imot endringsforslag som merge requests. En merge request (MR) er et forslag for å inkorporere endringer som leverer som en form for redigert kopi av opprinnelig tekst.

Prosess for å gi tilgang til eksterne brukere er under utarbeidelse, vi vil oppdatere denne siden med mer info når det foreligger. Inntil videre må eksterne brukere melde endringsforslag til kontakt@sikt.no.

Krav til format​

Beskrivelser i katalogen skrives i Markdown (CommonMark) og publiseres offentlig.

Hvilken informasjon (innhold og metadata) må med i katalogen?​

Kjente problemer med løsningen​

Det er dessverre noen begrensninger i publiseringsverktøyet vårt som vi ikke har løst enda.

  1. Vi må sette feltene /slug/ og /title/ for at dokumentene skal få riktig URL og tittel.