plan: the docs count things by hand, and one of those counts is already wrong #1860
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!1860
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "plan/1117-1510"
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?
Forward plan only, no code.
docs/plans/doc-counts.md.The docs quote three kinds of numbers about the code - suite check counts, the
showcensus, table sizes - and nothing measures any of them. Measured ond81e56dd:N checksclaims (26 indocs/ARCHITECTURE.md); 28 name atest/*.test.jsin the same sentence.ARCHITECTURE.md:1108saystrunk-allowed-add-removehas 47 checks; it prints 57 (#1831 added ten).docs/CLI.md:2339quotes 54 forms, 108 commands, 66 refusals -docs-show-commands.test.jsprints exactly those and asserts only a floor (:92,>= 40). The sentence was hand-rewritten in #1780, #1852 and #1854.ARCHITECTURE.md:732still says the twelve words one section after #1858 titled it thirteen, whileengine/cli.js:394-408holds 13 entries.Steps: export
tally()fromscripts/run-tests.js(S) ->test/doc-counts.test.jswith a paragraph-join matcher and a self-proving fixture (M) -> clear the two live defects (S) -> letdocs-show-commands.test.jsown its census (M). The two hard shapes ("Neighbours green", "reverting fails N") are deliberately deferred.Closes no open issue; the queue is seven device requests. Does not overlap
doc-citations.md(file:line drift).