Granska vår metod
Reproducera Skolkoll-betyget från specifikation, testdata och skript, och skicka in egen granskning.
Snabbkoll
Score v1, vikter, trösklar, formler och ett arbetat exempel som ska landa på 74.
Paketet är öppet på GitHub; seriösa metodgranskningar publiceras med svar och rättelser.
Specifikation, syntetisk fixtur, verkligt utdrag och reproduktionsskript pekar mot aktuell main.
1. En inbjudan att granska
Skolkoll-betyget är ett sammanvägt mått som bygger på offentlig data från Skolverket, SCB och Kolada. Ett sådant mått är bara så trovärdigt som dess metod är öppen. Därför har vi gjort hela beräkningen granskningsbar: varje vikt, tröskel och formel är dokumenterad och hänvisad till en rad i koden, och vi har packat ihop allt som behövs för att räkna om betyget från grunden — utan tillgång till vår server.
En extern statistiker ska kunna reproducera betyget från det här paketet ensamt. Detgenomarbetade exemplet i specifikationen utgår från fem dimensioner ([80, 70, 67, 85, 60] vid vikterna [0,30, 0,25, 0,20, 0,15, 0,10]) och landar påSkolkoll-betyget 74 — samma värde som verifieras live i testsviten. Får du fram en annan siffra har antingen vi eller du hittat något, och då vill vi höra det.
Granskningspaketet
De mergade, versionsmärkta artefakterna ligger öppet på GitHub. Länkarna nedan pekar på den aktuella versionen i main; specifikationen är versionsmärkt (v1 / scoreVersion 1.0.0), och för att reproducera en exakt historisk betygsversion använder du motsvarande taggade release.
- Specifikation: Skolkoll-betyget v1 — den fullständiga metodbeskrivningen (
scoreVersion 1.0.0) med alla vikter, trösklar och formler, var och en hänvisad till en rad i beräkningskoden samt, där ett gyllene värde finns, till paritetstestet. - Testdata: syntetisk pool — den primära reproducerbara fixturen. Helt påhittade skolor (A–E) och statistik, så att det inte finns någon integritetsrisk; tänkt att matas rakt in i reproduktionsskriptet.
- Testdata: verkligt utdrag — ett litet, integritetssäkert urval ur det publika datasetet (skolnivåstatistik utan persondata), så att du kan kontrollera metoden mot riktiga siffror och inte bara mot konstruerade fall.
- Reproduktionsskript — ett fristående Node-skript som räknar om Skolkoll-betyget från fixturerna ovan, så att du kan verifiera siffran end-to-end på din egen maskin.
Hur de underliggande siffrorna räknas fram beskrivs öppet på metodsidan. Den här sidan handlar om hur du kan kontrollera oss.
2. Vad vi förbinder oss till
Ett löfte som inte kan svida är inte trovärdigt. Därför är det här ett verkligt åtagande, inte en marknadsföringsfras:
Vi publicerar metodgranskningar och kritik i sin helhet — även den som är kritisk mot oss — utan att censurera den.
Vi vill vara ärliga om vad det här är och inte är. Det finns ingen automatisk funktion i produkten som publicerar inkomna granskningar. Det här är ett redaktionellt åtagande: när vi får en seriös granskning åtar vi oss att publicera den — exempelvis på en metodgranskningssida eller iändringsloggen — tillsammans med vårt svar och eventuella rättelser. Vi beskriver alltså ett löfte vi tänker hålla, inte ett systembeteende som redan är byggt. Skulle granskningen visa att betyget är fel rättar vi det och redovisar ändringen öppet.
3. Så skickar du in en granskning
Skicka din granskning, fråga eller invändning tillinfo@skolkoll.se. Det är samma kanal som vi redan i dag bjuder in granskare genom imetodpolicyn. Beskriv gärna vilken del av metoden det gäller — en viss dimension, vikt, tröskel eller en rad i specifikationen — så blir svaret konkretare. Du kan också nå oss via stöd-sidan.