docs: every page that states the catalogue total is written by the generator - README and CONNECTORS were 4 models and 164 sockets behind #1671
No reviewers
Labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
jaylouisw/packetforge!1671
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "fix/1116-1335"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
No open code issue this run (the queue is
[Device]:requests plus #1507, which needs the host), so this is the defect the last two merges left in reach.What was wrong
Only
docs/DEVICE_REGISTRY.mdhad a generator and a test.README.mdanddocs/CONNECTORS.mdstate the same totals by hand, and both were stale:(2210 models, 25016 sockets, 867 distinct port shapes)(2214 models, 25180 sockets, 869 distinct port shapes)The drift is one afternoon old: #1665 (Zyxel GS1900, +7) and #1667 (D-Link DGS-1520, +4) each regenerated the registry page and nothing else, and nothing looked at the other two.
What changed
scripts/regen-registry-doc.jsnow owns every page that states a number: the registry headline + table (unchanged), README's**N models across M vendors**sentence, and CONNECTORS' prose sentence and pasted sweep output.--checkreports all three;npm run regen:registry-docfixes all three.scripts/catalogue-shapes.js- it lived only in the faceplate sweep, and the generator needs the same definition, or the page quotes a number the suite does not print.test/doc-catalog-counts.test.jsasserts README and CONNECTORS against the directory, asserts every page equals what the generator would write, and proves a plausible wrong number on either page is caught and repaired in place without reflowing the paragraph.Reproduce the failure first
Reverting README and the pasted block to their values from
maingives35 passed, 6 failed: the README count, the three pasted numbers, and bothis currentchecks.Gates
node scripts/syntax-check.js- 351 files, all OKnode scripts/check-control-bytes.js- clean;node scripts/audit-port-types.js- cleannode test/doc-catalog-counts.test.js- 41/41;node test/faceplate-catalogue.test.js- 14/14--concurrency=2is not trustworthy here -canonical-urlsand another suite both edit README, which is a separate proposal)Not done: #1507 still needs the host.
This branch conflicts with
main, so it was not rebased:A conflict is a decision about behaviour rather than a mechanical fix, so this is left for a human. Rebasing by hand and force-pushing will let the automation pick it up again.
Merged as
1ab9f597. Record of the final state after the merge from main:node scripts/regen-registry-doc.js --check- all five pages current at 2,216 models across 252 vendors, 25,216 sockets, 870 distinct port shapes (main had moved twice while this was open: #1668 had to repair README + CONNECTORS + wiki Home + the build-wiki template by hand, and #1669 added the Netonix pair).node test/doc-catalog-counts.test.js- 43/43;node test/faceplate-catalogue.test.js- 14/14;node test/catalogue-hygiene.test.js- 25/25.35 passed, 6 failed; staling the wiki line gives42 passed, 1 failednamingdocs/wiki/Home.md.Still open and not mine: #1507 (the 46 GB firmware repository) needs the host.