summaryrefslogtreecommitdiff
path: root/docs/typ/building.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/building.typ')
-rw-r--r--docs/typ/building.typ5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/typ/building.typ b/docs/typ/building.typ
index d957ff94..a261a913 100644
--- a/docs/typ/building.typ
+++ b/docs/typ/building.typ
@@ -97,6 +97,11 @@ zig build cheatsheet render the cheatsheet PDF (needs typst)
- `zig build monkey -Dplatform=tty -- <seeds> [steps] [--from=N] [--out=DIR] [--keep]` writes one random script per seed and keeps any
that panics; a seed always makes the same script. Each crash found gets a
fix and a regression script in `test/snapshots/`.
+- The tutor's practice blocks (`# keys:`, `# before`, `# after` in
+ `src/tutor.txt`) are typed by hand; nothing runs them. What pins that
+ behaviour is `hxdiff`, which replays `test/hxcases` against goldens
+ recorded from a real helix, and `hxparity`, which runs each case in a
+ file pane and in a shell and demands they agree.
- `zig build hxdiff -- --strict cases.jsonl reference.jsonl [waivers.jsonl]` runs custom differential cases. `docs/helix-keys.md`
tracks helix parity key by key and names the reference helix build;
`docs/selections.md` is the selection model under normal mode.