From d3638abbb3d177ea08beed3b09cd9682b3732daf Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Thu, 1 Oct 2026 11:03:21 -0300 Subject: The docs give back the day-one lines the trim cut, the tutor becomes exercises on a +Tutor copy, the README builds the GUI and says what a terminal needs, and Shift-Esc says it needs the kitty keyboard protocol Co-Authored-By: Claude Opus 5.5 --- docs/typ/building.typ | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'docs/typ/building.typ') 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 -- [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. -- cgit v1.3