Metode og redaksjonelle prinsipper

Her beskriver vi hvordan KalkNorge velger kilder, bygger beregningsmodeller, tester kalkulatorer og følger opp endringer og feil. Metoden skal gjøre resultatene forståelige, etterprøvbare og ærlige om usikkerhet.

Sist gjennomgått 24. september 2026. Metoden gjelder for KalkNorges kalkulatorer, men den konkrete kalkulatorsiden er alltid den viktigste dokumentasjonen for formel, kilder, dato og begrensninger.

1. Vi avgrenser brukerens oppgave

Arbeidet starter med ett konkret spørsmål kalkulatoren skal hjelpe med. Vi definerer hvem resultatet er for, hvilke inndata brukeren normalt har tilgjengelig, hvilken enhet svaret skal vises i, og hvilke beslutninger kalkulatoren ikke kan ta. Nærliggende spørsmål samles bare når de hører naturlig til samme oppgave; vi lager ikke egne sider kun for små ordvariasjoner eller søkeord.

Før beregningsarbeidet begynner, undersøkes det om emnet er tidsavhengig eller kan påvirke økonomi, helse eller sikkerhet. Slike temaer krever tydeligere avgrensninger, mer direkte dokumentasjon og større varsomhet i hvordan resultatet presenteres.

2. Vi finner og vurderer kildene

Når regler, satser eller offentlige metoder inngår, prioriterer vi kilden som eier informasjonen: lover og forskrifter, myndighetenes egne veiledninger, offentlige datasett og teknisk dokumentasjon fra ansvarlig organ. Eksempler kan være Lovdata, Skatteetaten, NAV, Statistisk sentralbyrå, Helsedirektoratet, Direktoratet for byggkvalitet eller Statens vegvesen, avhengig av emnet. En sekundær artikkel kan hjelpe oss å oppdage et spørsmål, men erstatter ikke en tilgjengelig primærkilde.

For hver vesentlig kilde vurderes virkeområde, dato, gjeldende år, definisjoner, enheter og eventuelle unntak. Vi forsøker ikke å slå sammen tall fra ulike år eller definisjoner uten å forklare forskjellen. Historiske serier brukes bare når datapunktene er sammenlignbare og kan spores til en navngitt kilde.

3. Vi gjør regelen om til en synlig beregningsmodell

Formelen eller fremgangsmåten oversettes til eksplisitte trinn. Vi skiller mellom offisielle verdier, verdier brukeren oppgir, og KalkNorges egne scenarioantakelser. Der regelen har terskler, maksimumsgrenser, soner eller alternative forløp, dokumenteres hver gren. En standardverdi skal være praktisk og tydelig merket; den skal ikke framstå som en anbefaling dersom den bare er et eksempel.

Vi bestemmer også presisjon og avrunding. Beregningen beholder normalt mer presisjon internt enn det som vises, slik at tidlig avrunding ikke forplanter feil. Dersom en offentlig metode krever avrunding på et bestemt trinn, følger og forklarer vi den. Resultatsiden skal vise nok av beregningsgrunnlaget til at en leser kan gjenta kontrollen manuelt eller utfordre en antakelse.

4. Vi skriver forklaringen rundt resultatet

En kalkulator er ikke ferdig når den produserer et tall. Siden skal forklare hva resultatet betyr, hvordan de viktigste inndataene påvirker det, og hvilke åpenbare oppfølgingsspørsmål brukeren ellers måtte søke videre etter. Relevante sider inkluderer en kontrollert eksempelberegning, vanlige feil, praktiske begrensninger og minst to nyttige forklarende elementer, for eksempel en scenarioanalyse, en oppdeling, en sammenligning, en tabell eller en grafisk figur.

Innholdet skrives for mennesker som vil løse oppgaven, ikke for å fylle en bestemt tekstlengde eller gjenta søkeord. KalkNorge har en intern dybdestandard for kalkulatorartikler, men antall ord er aldri i seg selv et kvalitetsbevis. Generell bakgrunn, gjentakelser og tekst som ikke hjelper leseren, skal fjernes.

5. Vi tester beregningen og siden

Hver kalkulator skal testes med et vanlig scenario, en manuelt kontrollert eksempelberegning, relevante grenseverdier og ugyldige eller ufullstendige inndata. Vi kontrollerer enheter, fortegn, prosent- og desimalhåndtering, avrunding, minimums- og maksimumsverdier og alle vesentlige regelgrener. Resultat, forklaring, eksempel, tabeller, figurer, metadata og eventuelle strukturerte data skal fortelle det samme.

Den tekniske kontrollen omfatter også at resultatet oppdateres når inndata endres, at feilmeldinger er forståelige, og at innholdet kan brukes med mobilskjerm, tastatur og hjelpemidler så langt løsningen støtter det. Automatiske tester brukes der de gir pålitelig dekning, men de erstatter ikke vurderingen av om svaret faktisk er nyttig og rimelig.

6. Vi gjennomfører en separat kvalitetsvurdering

Før en ny kalkulator kan publiseres, skal den gjennom en egen side-spesifikk vurdering adskilt fra selve implementeringen. Vurderingen kontrollerer blant annet brukerformål, original nytte, kilder, formel, eksempel, datoer, unntak, språk, personvern, visuelle forklaringer og samsvar mellom alle deler av siden. Utfallet og konkret kontrollbevis registreres i en kvalitetslogg. En automatisert eller agentbasert gjennomgang omtales ikke som menneskelig faglig godkjenning.

På områder med stor konsekvens kan en generell redaksjonell kontroll ikke erstatte en kvalifisert fagpersons vurdering av en individuell sak. KalkNorge skal derfor bruke nøkterne formuleringer, peke på usikkerhet og henvise videre når kalkulatorens mandat slutter.

7. Vi publiserer med sporbarhet og vedlikeholder siden

En publisert kalkulator viser direkte kildelenker og dato for siste faglige gjennomgang. Tidsavhengige tall merkes med år eller periode. Datoen oppdateres bare etter at kildene og beregningen faktisk er kontrollert; den endres ikke for å få gammelt innhold til å se nytt ut.

Regelendringer, nye kildedata, dokumenterte feil eller vesentlige endringer i kalkulatoren utløser en ny vurdering. Dersom en viktig opplysning ikke lenger kan bekreftes, skal siden korrigeres, merkes tydelig eller tas ut av publisert tilstand til problemet er løst.

Bruk av KI og andre automatiserte verktøy

KI og annen automatisering kan brukes til å foreslå struktur, hjelpe med kode, finne mulige testtilfeller, kontrollere konsistens og bearbeide språk. Verktøyene kan ta feil og regnes aldri som dokumentasjon. Vesentlige fakta, satser og regler må kontrolleres mot de oppgitte kildene, og beregningsresultater må testes mot kjente eller manuelt utregnede eksempler. Det avgjørende er kvaliteten og etterprøvbarheten i den publiserte siden, ikke hvilket verktøy som bidro i arbeidsprosessen.

Rettelser, tilbakemeldinger og uavhengighet

Hvis du finner en mulig feil, send kalkulatorens navn og nettadresse, nødvendige eksempelverdier, resultatet du forventet og en relevant kilde til [email protected]. Ikke send sensitive personopplysninger. Feil som kan gjenskapes og dokumenteres, prioriteres for undersøkelse og retting.

KalkNorge skal ikke endre metode eller konklusjon for å favorisere en offentlig eller kommersiell aktør. Eksterne lenker brukes for dokumentasjon og betyr ikke at kilden anbefaler KalkNorge. Tjenesten er ikke en offentlig myndighet, og en KalkNorge-beregning kan aldri overstyre et vedtak, en avtale, en faglig undersøkelse eller gjeldende regelverk.

Metodens begrensninger

Alle kalkulatorer er modeller av virkeligheten. De kan ikke kjenne alle lokale bestemmelser, kontraktsvilkår, individuelle forhold eller framtidige endringer. Testing reduserer risikoen for feil, men garanterer ikke at alle kombinasjoner og særtilfeller er dekket. Les derfor alltid forutsetningene på den aktuelle siden og kontroller viktige beslutninger hos den instansen eller fagpersonen som har ansvar for saken.