docgen

Overview ¶

Command docgen generates MATCHERS.md — the flat, single-file catalog of every matcher across all be packages, grouped by intent, with an "instead of" column for the raw idioms each matcher supersedes.

One flat file (rather than per-package READMEs) is deliberate: to look inside be_math/README.md you must already know be_math exists. The catalog is the discovery surface for humans and LLM agents alike.

Run from the repo root (generate-docs.sh does):

go run ./internal/docgen > MATCHERS.md