docs: skills simuler and forbedre, README, changelog and contribution guide

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>

BIDRA.md

@@ -0,0 +1,68 @@
+# Bidra med en forbedring
+
+Modellen er en første versjon, og notatet *Den dynamiske rettsstaten* er skrevet som en invitasjon til videre arbeid.
+Har du forbedret modellen, rettet en feil eller prøvd den mot data, tas det gjerne imot. Denne siden sier hvordan du
+sender det, og hva et bidrag må ha for at det kan vurderes.
+
+## Slik sender du det
+
+Repositoryet ligger på en egen Forgejo-server der utenforstående ikke kan registrere seg, så bidrag kommer på
+e-post: **hello@fromaitochitta.com**.
+
+Send:
+
+1. **Endringen**, som en patch eller som de endrede filene.
+   - Har du klonet repositoryet med git, lag patchen med `git format-patch origin/main` (én fil per commit).
+   - Har du en arbeidskopi fra pluginen (`rettsstat-modell/`), kan du legge den i git før du endrer noe
+     (`git init`, `git add -A`, `git commit -m "utgangspunkt"`) og lage patchen med `git format-patch -1` etter at
+     endringen er committet. Uten git: send filene du har endret eller lagt til, med stien i kopien.
+2. **Utskriften fra kontrollen** på modellen med endringen:
+   `python3 modell/kjor.py kontroll` i arbeidskopien eller klonen (den fulle, ikke `--rask`).
+3. **Scenariofilene** som viser hva endringen gjør, og gjerne sammendragene kjøringene skrev.
+4. **En kort forklaring**: hva endringen gjør, hvorfor (hypotesen, gjerne med kilde), og hva kjøringene viser.
+
+## Hva et bidrag må ha
+
+- **Én mekanisme eller én endring om gangen.** To endringer i samme bidrag gjør det umulig å si hva som ga hvilket
+  utslag.
+- **For en utvidelse** (en ny mekanisme i `modell/utvidelser/`): et grensetilfelle som gjenskaper kjernen eksakt
+  (største avvik `0.0`), og en test som viser det. `grensetilfelle()` og grensesnittet står i `docs/utvidelser.md`;
+  testen av grensetilfellet følger med automatisk, men legg gjerne til en test av det mekanismen gjør utenfor
+  grensetilfellet. Kontrollen skal si «bit for bit som notatet» eller «innenfor toleranse».
+- **For en endring i kjernen** (`modell/kjerne/`): listen over notatets resultater som flytter seg (kontrollen sier
+  hvilke datafiler og utskrifter, og hvor mye), hvilken figur eller tabell i notatet de hører til
+  (`docs/modellkart.md`, del (d)), og hvorfor det er ment. Kjernen er en kopi av notatets kode, så en endring der
+  må også inn i notatets repository før den kan tas inn i pluginen.
+- **Ingen persondata og ingen data fra enkeltsaker.** Modellen brukes på kategorier og aggregerte tall. Data til
+  kalibrering må være aggregerte og ha en oppgitt kilde.
+- **Påstander bygger på kjøringer.** Et bidrag som sier at modellen «gir» noe, har med kjøringen som viser det.
+
+## Det som er særlig velkomment
+
+Veiplanen i avsnitt 10 i notatet har åtte punkter. Disse kan gjøres i modellen:
+
+- **Kalibrering mot norske data** (punkt 5), blant annet politiets metningsnivå `K_sat` per sakstype, virkningen av
+  ulike reaksjonsformer og om det finnes rekrutteringsterskler i bestemte kategorier.
+- **Estimering av faktisk reaktivitet og forsinkelse** i budsjett- og prioriteringsprosessene, og av
+  stabilitetsgrensen for en inkrementell regel (punkt 2).
+- **En kjedemodell med kø og frafall i alle fire ledd**, flere sakstyper, ulike behandlingstider og tilbakeløp
+  (punkt 3). I dag har bare domstolen kø.
+- **Simuleringer med målestøy, skjevhet og parameterusikkerhet** (punkt 4). I dag antar alle simuleringene et
+  feilfritt estimat.
+- **Kostnadsfunksjoner i kroner** og en nytte-kostnadsvurdering av tiltakene, med forebygging som alternativ
+  (punkt 6).
+- **En romlig versjon** med forskyvning mellom distrikter, og en modellprediktiv styring av hele tiltaksvektoren
+  (punkt 8).
+
+Punkt 1 (flaskehalsdiagnose av hele kjeden på norske tall) og punkt 7 (beslutningsrettigheter, hjemler og
+budsjettmekanikk) er ikke modellkode, men innspill til dem tas også imot. Det samme gjelder rettelser, også små.
+
+## Lisens
+
+Bidrag tas inn under MIT-lisensen, som resten av pluginen (`LICENSE`). Ved å sende et bidrag sier du deg enig i det,
+og i at du har rett til å gi det under den lisensen.
+
+## Hva du kan vente deg
+
+Dette er et privat prosjekt uten fast bemanning. Det er ikke lovet noe svar innen en bestemt tid, og ikke at et
+bidrag blir tatt inn. Bidrag som følger punktene over, er lettest å vurdere.