zigman/src/ at main · zzstoatzz.io/zigman · Tangled

zzstoatzz.io / zigman

0

zig langref cli nate.tngl.io/zigman

0

zigman / src

3 files

at main

zzstoatzz usability: stop short-query noise; state scope (not toolchain advice) on a miss 5w ago

usability: stop short-query noise; state scope (not toolchain advice) on a miss dogfooding zigman to write an HTTP server surfaced two things; both fixed within the existing `zigman <query>` surface: - queries < 3 chars that aren't an exact section go straight to no-match instead of substring-matching unrelated titles ("Io" -> "Introduction"/"Test-Declarations"). exact 2-char sections like `if` still resolve. - a no-match now states what zigman *is* — "(the langref covers the Zig language, not std)" — so a std-ish miss reads as out-of-scope, not a broken tool. it does NOT instruct how to find std (zig env / std-source grep): that would make the binary editorialize about the rest of the toolchain, and it's wrong on typos. the std-lookup how-to stays in the guide/skill where it belongs. 11/11 tests, fmt clean, binaries rebuilt. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

1 month ago

rename version flag to -V/--version, generate homepage from README - langref version flag is now -V/--version <ver> (was --zig); "version" reads naturally as "which docs version" in a reference tool - replace the confusing `sentinel` example with `error`/`pointer` - rewrite README for clarity; generate www/index.html from it at build time via a tiny in-repo md->html tool (tools/md2html.zig) so page and README never drift - drop the prominent trafilatura credit (all code is our own; only a generic "preserve structure" idea was borrowed) — keep a short note in render.zig Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

1 month ago

usability: resolve fuzzy queries to the obvious section, never dead-end loop-derived (a not-too-smart agent types natural queries, not exact anchors): - primaryMatch: when several sections match, open the one whose normalized title/id equals the query (modulo plural) or uniquely prefixes it — so `optional`->Optionals, `error union`->Error Union Type, `slice`->Slices, instead of dumping a candidate list. genuinely ambiguous queries (`sentinel`) still list. - collectWords: a multi-word query that matches nothing as a phrase retries on individual words, so `labeled block` surfaces Blocks + Labeled-switch/while/for instead of "no section matching". no dead ends. both stay within the existing `zigman <query>` surface (no new flags). +regression tests. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

1 month ago