docs: bring skills and docs in line with the fixed code
Skills ask before using a working copy found in the user's folder and state its check level first. The drift of the queue models before the shock is stated in the caveats and the README. README shows how to run the check and the tests. The drift line names the month a gradual drive begins. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
parent
776325c680
commit
19858bbda9
13 changed files with 314 additions and 113 deletions
12
BIDRA.md
12
BIDRA.md
|
|
@ -17,7 +17,9 @@ Send:
|
|||
(`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`).
|
||||
`python3 modell/kjor.py kontroll` i arbeidskopien eller klonen (den fulle, ikke `--rask`, og med numpy og scipy,
|
||||
så alle seks delene er kjørt). Kontrollen måler mot notatets egne sjekksummer, som står fast i
|
||||
`modell/kontroll.py`; endre ikke den fila eller `fasit/`.
|
||||
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.
|
||||
|
||||
|
|
@ -27,10 +29,12 @@ Send:
|
|||
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».
|
||||
testen av grensetilfellet følger med automatisk. Oppgi `GJENSKAPER_NOTATET` når standardverdiene gjenskaper noen
|
||||
av notatets scenariofiler, så sjekkes grensetilfellet også mot notatets datafiler, og legg gjerne til en test av
|
||||
det mekanismen gjør utenfor grensetilfellet. Kontrollen skal si «bit for bit som notatet» eller «innenfor
|
||||
toleranse». Sier den at utvidelsen ikke gjenskaper kjernen i grensetilfellet, er utvidelsen feil.
|
||||
- **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
|
||||
hvilke datafiler, utskrifter og scenariofiler, 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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue