The device-registry page said 22 models. It was 1,717. #1123

Merged
jaylouisw merged 1 commit from docs/catalog-counts into main 2026-11-08 20:14:35 +00:00
Owner

docs/DEVICE_REGISTRY.md ended with:

Included catalog — 22 models across 7 vendors: Cisco (ISR 4321, Catalyst 2960, Catalyst 9300, ASA 5506), Juniper (MX204, EX2300), Arista (7050SX3, 7280SR), MikroTik (CRS326, CCR1036), Huawei (S5735, AR6140), Ubiquiti (EdgeSwitch 16, EdgeRouter 4), plus 9 generic models.

A true sentence about a catalogue that no longer exists. It is 1,717 models across 245 vendors now, and it has been for a long time — nobody was lying, prose just goes stale and nothing was watching it.

What it says now

vendor models category models
MikroTik 353 router 225
Ubiquiti 317 switch 211
Aruba 72 point-to-point 196
Huawei 64 wireless 186

…and it states plainly that the directory is authoritative, that GET /api/catalog is the real list, and that this section is prose which goes stale.

And it is watched now

test/doc-catalog-counts.test.js reads both counts and every table cell out of the document and asserts them against the directory — 1,717 models, 245 vendors, MikroTik 353, Ubiquiti 317, switch 211, and so on. A catalogue addition that does not touch this page now fails a test instead of quietly making the documentation wrong.

That is the same lesson as the stale CI docs earlier: a number in prose is a claim, and a claim needs something checking it or it decays.

Full suite: 111 suites, 4968 assertions, 0 failed.

`docs/DEVICE_REGISTRY.md` ended with: > **Included catalog** — 22 models across 7 vendors: Cisco (ISR 4321, Catalyst 2960, Catalyst 9300, ASA 5506), Juniper (MX204, EX2300), Arista (7050SX3, 7280SR), MikroTik (CRS326, CCR1036), Huawei (S5735, AR6140), Ubiquiti (EdgeSwitch 16, EdgeRouter 4), plus 9 generic models. A true sentence about a catalogue that no longer exists. It is **1,717 models across 245 vendors** now, and it has been for a long time — nobody was lying, prose just goes stale and nothing was watching it. ### What it says now | vendor | models | | category | models | |---|---:|---|---|---:| | MikroTik | 353 | | router | 225 | | Ubiquiti | 317 | | switch | 211 | | Aruba | 72 | | point-to-point | 196 | | Huawei | 64 | | wireless | 186 | …and it states plainly that the directory is authoritative, that `GET /api/catalog` is the real list, and that this section is prose which goes stale. ### And it is watched now `test/doc-catalog-counts.test.js` reads both counts **and every table cell** out of the document and asserts them against the directory — 1,717 models, 245 vendors, MikroTik 353, Ubiquiti 317, switch 211, and so on. A catalogue addition that does not touch this page now fails a test instead of quietly making the documentation wrong. That is the same lesson as the stale CI docs earlier: a number in prose is a claim, and a claim needs something checking it or it decays. Full suite: 111 suites, 4968 assertions, 0 failed.
The device-registry page said 22 models. It was 1,717.
Some checks failed
CI / Test (Node 18) (pull_request) Successful in 1m47s
CI / Test (Node 20) (pull_request) Successful in 1m45s
CI / Server smoke test (pull_request) Successful in 34s
CI / Docker build (pull_request) Successful in 39s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Failing after 16s
CI / Test (Node 22) (pull_request) Successful in 1m37s
13d9e1b57d
"Included catalog: 22 models across 7 vendors" has been at the bottom of
docs/DEVICE_REGISTRY.md since long before the catalogue grew past a thousand. It listed
Cisco, Juniper, Arista, MikroTik, Huawei, Ubiquiti and 9 generic models - a true sentence
about a catalogue that no longer exists.

Now it states what is actually there, with the largest vendors and categories, and says
plainly that the directory is authoritative and this section is prose that goes stale.

And it is watched: test/doc-catalog-counts.test.js reads both counts and every table cell
out of the document and asserts them against the directory - 1,717 models, 245 vendors,
MikroTik 353, Ubiquiti 317, switch 211, and so on. A future addition that changes the
catalogue without touching this page now fails a test instead of quietly making the
documentation wrong.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!1123
No description provided.