Skip to content

docs: make the README front-door examples and counts true, and guard them - #4474

Open
stmr wants to merge 1 commit into
limitlessprojects:mainfrom
stmr:docs/readme-front-door-examples
Open

stmr wants to merge 1 commit into
limitlessprojects:mainfrom
stmr:docs/readme-front-door-examples

Conversation

@stmr

@stmr stmr commented Nov 14, 2026

Copy link
Copy Markdown

Fixes #4473.

  • README.md: the hero example uses the real API (pub fn, regex.is_match(pat, raw)?); both build lines name an input (hyb build checkout.hy --package hybrid --out-dir hybrid, hyb build examples/09-go-imports-hybrid/program.hy --package mypkg ...); counts become 139/139, differential 47/47 + 92/92.
  • SPEC-LANGUAGE.md: the two bare managed { examples use managed("reason", "category") {.
  • tools/check_corpus_census.py: README corpus pattern accepts (N/N); new check ties every README differential … a/a + r/r claim to ACCEPT+ACCEPT-MANAGED / REJECT (8 surfaces now).
  • tools/test_check_corpus_census.py: parenthesised-stale, stale-accept, stale-reject, denominator-only and lost-claim tests.
  • compiler/crates/hyb/tests/readme_examples.rs: every README hy block must pass hyb check; every README hyb build line must name a .hy.

Tests: the new census tests fail 5/5 on main's script and pass 24/24 with the fix; python3 tools/check_corpus_census.py OK (fails on main's README with the three stale claims); check_test_registration.py and check_claims_links.py OK; cargo +1.99.0 test -p hyb --test readme_examples 2/2 (both fail on main's README).

… (README example, build --package, spec managed examples)
@github-actions github-actions Bot added the bot:land-candidate Shepherd: fresh, gate-clean, verifiable (set from classify()) label Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bot:land-candidate Shepherd: fresh, gate-clean, verifiable (set from classify())

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README front-door example fails hyb check, its build commands can't run, and the quoted corpus counts are stale (make census passes anyway)

1 participant