norefs documentation
Eight pages, one topic each:
- What norefs finds — every check, the six verdicts, and
--production mode
- Configuration — the config file, boundaries, suppression comments, entry points, monorepos
- Corpus validation — a dated regression log of runs on real, widely used repositories
- Dependencies — what counts as using a package, and the misplaced-entry check
- Fixing automatically — what
--fix removes, verifies, refuses, and points out
- Flags — what every flag and combination does to a working tree, and the exit codes
- Limitations — what counts as usage, when norefs stays silent, the remaining blind spots
- Speed — fast runs with
--only, the synthetic shapes, and watch mode
The README is the front door,
and the changelog records what each release changed and why.