Metodpolicy

Hur Skolkoll dokumenterar beräkningsmetoder, hanterar förändringar och arbetar med transparens.

Dokumentationsprinciper

Alla beräkningar dokumenteras i metric-definitions.json — en maskinläsbar datakatalog med 80+ mått.
Varje mått har: namn, enhet, intervall, datakälla och beräkningsmetod.
Definitioner följer Skolverkets och SCB:s officiella definitioner i första hand.
Avvikelser från officiella definitioner markeras explicit i variabelordboken.

Se variabelordboken för en fullständig förteckning.

När en beräkningsmetod ändras eller en ny datakälla tillkommer följer vi dessa steg:

Identifiering — Ny datakälla, förändrad beräkningslogik eller korrigering av befintlig metod identifieras.
Dokumentation — metric-definitions.json uppdateras med nya eller ändrade definitioner.
Kommunikation — En post läggs till i ändringsloggen som beskriver vad som ändrats och varför.
Verifiering — Resultat jämförs med föregående version för rimlighetskontroll. Stora avvikelser utreds före publicering.
Publicering — Deploy genomförs med uppdaterad dokumentation och data samtidigt.

Metodförändringar publiceras i ändringsloggen innan eller samtidigt med att ny data publiceras.
Bakåtinkompatibla förändringar aviseras minst en version i förväg.
Beräkningsmetoder och datakällor dokumenteras öppet på metodsidan.

Nuläge: Skolkoll är ett enmansprojekt. Metod och beräkningar granskas internt.
Målbild: Extern granskning av statistiker eller forskare med relevant kompetens.
Nästa steg: Vi välkomnar granskare — kontakta oss via info@skolkoll.se eller stöd-sidan.

Skolkoll är inte en officiell statistikproducent — vi sammanställer och tillgängliggör offentlig data.
Data kan avvika från Skolverkets publiceringar på grund av timing eller aggregeringsnivå.
Modellberäkningar (t.ex. SALSA) följer publicerad metod men kan ha implementationsskillnader.
Jämförelser mellan skolor bör alltid göras med hänsyn till datakvalitet och socioekonomiska faktorer.