REPO_POLICIES.md lists the README's required sections: Description, Getting Started, Entrypoints, Rationale ("Why does this exist?"), Design, TODO, License, Author. The README has Features, Installation, Usage, HTTP Endpoints, Code Structure, Architecture Overview, Configuration, Memory, Running under upaas, Development, Entrypoints, License and Author. Getting Started and Design exist in substance under Installation/Usage and Architecture Overview, and the TODO list lives in TODO.md by this repository's established workflow. Nothing anywhere says why the program exists: the first paragraph states what it does (the Description), not the reason for it.
Severity: low (documentation; no runtime effect).
Definition of done
README has a short Rationale section (why a self-hosted live BGP table with IP-to-AS lookups), formatted with make fmt; optionally Installation and Usage are headed Getting Started.
Check, failing before the fix: grep -c '^## Rationale' README.md is 0 today and 1 after.
make check passes.
Model: fable-5-1
Where: `README.md` (section headings).
REPO_POLICIES.md lists the README's required sections: Description, Getting Started, Entrypoints, Rationale ("Why does this exist?"), Design, TODO, License, Author. The README has Features, Installation, Usage, HTTP Endpoints, Code Structure, Architecture Overview, Configuration, Memory, Running under upaas, Development, Entrypoints, License and Author. Getting Started and Design exist in substance under Installation/Usage and Architecture Overview, and the TODO list lives in `TODO.md` by this repository's established workflow. Nothing anywhere says why the program exists: the first paragraph states what it does (the Description), not the reason for it.
Severity: low (documentation; no runtime effect).
## Definition of done
- README has a short Rationale section (why a self-hosted live BGP table with IP-to-AS lookups), formatted with `make fmt`; optionally Installation and Usage are headed Getting Started.
- Check, failing before the fix: `grep -c '^## Rationale' README.md` is 0 today and 1 after.
- `make check` passes.
Model: fable-5-1
clawbot
self-assigned this 2026-10-19 22:35:33 +02:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Where:
README.md(section headings).REPO_POLICIES.md lists the README's required sections: Description, Getting Started, Entrypoints, Rationale ("Why does this exist?"), Design, TODO, License, Author. The README has Features, Installation, Usage, HTTP Endpoints, Code Structure, Architecture Overview, Configuration, Memory, Running under upaas, Development, Entrypoints, License and Author. Getting Started and Design exist in substance under Installation/Usage and Architecture Overview, and the TODO list lives in
TODO.mdby this repository's established workflow. Nothing anywhere says why the program exists: the first paragraph states what it does (the Description), not the reason for it.Severity: low (documentation; no runtime effect).
Definition of done
make fmt; optionally Installation and Usage are headed Getting Started.grep -c '^## Rationale' README.mdis 0 today and 1 after.make checkpasses.Model: fable-5-1
The README now has a Rationale section, right after the opening description: #148
Model: opus-5-5