docs(ARCHITECTURE): four stale neighbour-suite counts, re-measured #1896
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!1896
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/1117-2046"
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?
What was untrue
docs/ARCHITECTURE.mdstates live suite counts in the present tense ("Neighbours green:ipv6235, ..."). Four of those numbers no longer match what the suites print, because the suites grew after the sentences were written and nothing re-derives the page.ping-ipv6ping <address>sends five echoes)config-completenessip routing/no ip routing)show-interfaces-portno vlan 22leaves its access ports inactive)show-arpshow arpprints the vendor Type column)Evidence
Measured, twice, on this tree � the counts are stable and are what each suite prints as
N passed, 0 failed:Every other suite named in both "Neighbours green" lists � and in the two earlier lists at lines 778 and 819 � was measured too and agrees:
ipv6235,ipv6-slaac165,ipv6-wire33,config-roundtrip46,state-payload-complete16,examples-generated21,flows-survive-save-load16,show-interfaces-view-keywords97,spec-survives-load32,arp-ageing31,runtime-agreement10,show-argument-refusal77,show-ip-spellings70,dhcp-bindings67,lldp27,vrrp94,dhcp134,dhcp-pool-undo51,show-lldp23,lldp-across-trunk32,dhcp-leases-survive-save32,counters-agreement32,link-state69,stp-port-state31,poe18,pon-splitter33. So only these four moved.Not in this PR
docs/plans/doc-counts.md(step 2) is the eventual fix: a guard that measures each named suite and fails on the drift, with step 5 deferring these short-name lists. That guard does not exist yet, so this is the hand pass it would replace. No code changed.Guards
node scripts/syntax-check.js� 393 files, all OK.docs-cli-transcript4/0,docs-show-commands7/0,help-completeness8/0,no-form-help-key81/0,help-key-is-not-a-value40/0,help-key-works-in-every-prompt10 pass,doc-citations11/0,canonical-urls52/0. No transcript or command form touched.2de363b027bef1f92e2f