Skriva en teknisk rapport

En teknisk rapport har ett jobb: låta en annan person förstå, bedöma och upprepa det du gjorde. Struktur:

1. Sammanfattning (5 meningar): problem, metod, huvudresultat med siffra och osäkerhet, begränsning.
2. Problem och hypotes: vad, varför, vad som skulle falsifiera.
3. Metod: data (källa, storlek, split, licens), modell, träning, utvärdering, baslinjer — tillräckligt för att upprepa.
4. Resultat: tabeller med medel ± spridning, KI; figurer med axlar från noll där det är rimligt; inga tolkningar här.
5. Analys: ablationer, felanalys, vad som förvånade.
6. Begränsningar: ärligt — data, generalisering, kostnad, vad ni inte testade.
7. Reproducerbarhet: commit, data-hash, konfiguration, frön, hårdvara, tid.

Språk: «vår metod förbättrar F1 med 2,1 pe [0,4; 3,8] på testset X» — inte «vår metod är betydligt bättre». Varje adjektiv som inte har en siffra bakom sig stryks.

Skriv om:

Före	Efter
«Modellen presterar mycket bra.»	«Macro-F1 0,84 [0,81; 0,87] på 600 testfall, mot TF-IDF-baslinjens 0,77 [0,74; 0,80].»
«Vi testade många inställningar.»	«Vi sökte lr ∈ {1e-5, 2e-5, 5e-5} och epoker ∈ {2, 3, 5} på valideringsdata, lika för baslinje och modell (tabell 3).»
«Resultaten generaliserar troligen.»	«Vi har bara testat på svenska supportärenden från en organisation; generalisering till andra domäner är oprövad.»

Checklista före inlämning: varje siffra har osäkerhet · varje tabell har n · baslinjen är beskriven lika noga som metoden · begränsningar är konkreta · commit och data-hash står med · någon som inte var med kan följa metoden.