README: the medium catalogue is 90 media in ten families on 28 cages #1695

Merged
jaylouisw merged 2 commits from docs/1116-1646 into main 2026-11-16 16:53:10 +00:00
Owner

The front page claimed 89 media types across nine families and 26 connector cages. That was true when the line was last written (8e91b60b), and it has not moved since while the engine did.

Evidence from the code, not from a neighbour doc:

  • Object.keys(require('./engine/media').MEDIA).length = 90 (was 89 at 8e91b60b); the serial V.35 medium landed in #1483.
  • Object.values(MEDIA).map(m => m.family) has 10 distinct values - README listed nine, and the missing one is serial.
  • Object.keys(CAGES).length = 28 (was 26 at 8e91b60b): CFP2 (#1213) and the serial cage (#1483).
  • The engine's own suites agree: test/cable-legend-covers-every-medium.test.js prints "(90 media)" and test/cage-media-resolves.test.js prints "across 28 cages".

Both places in README.md are fixed: the feature bullet and the Physical layer table row. No other file touched.

Guards, before -> after: syntax-check 354 files OK -> 354 OK; control bytes clean -> clean; doc-citations script 352 citations -> 352; test/doc-citations.test.js 11/0 -> 11/0; test/docs-show-commands.test.js 7/0 -> 7/0; test/help-completeness.test.js 8/0 -> 8/0; test/doc-catalog-counts.test.js 43 -> 43.

Still stale, found in the same sweep and deliberately left for its own PR (one item per run): docs/PHYSICAL_LAYER.md:96 ("65 media across nine families ... 20 cages") and docs/SIMULATION.md:436 ("20 cages and 65 media").

The front page claimed **89 media types across nine families and 26 connector cages**. That was true when the line was last written (8e91b60b), and it has not moved since while the engine did. Evidence from the code, not from a neighbour doc: - `Object.keys(require('./engine/media').MEDIA).length` = **90** (was 89 at 8e91b60b); the serial V.35 medium landed in #1483. - `Object.values(MEDIA).map(m => m.family)` has **10** distinct values - README listed nine, and the missing one is `serial`. - `Object.keys(CAGES).length` = **28** (was 26 at 8e91b60b): CFP2 (#1213) and the serial cage (#1483). - The engine's own suites agree: `test/cable-legend-covers-every-medium.test.js` prints "(90 media)" and `test/cage-media-resolves.test.js` prints "across 28 cages". Both places in README.md are fixed: the feature bullet and the Physical layer table row. No other file touched. Guards, before -> after: syntax-check 354 files OK -> 354 OK; control bytes clean -> clean; doc-citations script 352 citations -> 352; `test/doc-citations.test.js` 11/0 -> 11/0; `test/docs-show-commands.test.js` 7/0 -> 7/0; `test/help-completeness.test.js` 8/0 -> 8/0; `test/doc-catalog-counts.test.js` 43 -> 43. Still stale, found in the same sweep and deliberately left for its own PR (one item per run): docs/PHYSICAL_LAYER.md:96 ("65 media across nine families ... 20 cages") and docs/SIMULATION.md:436 ("20 cages and 65 media").
docs: the medium catalogue is 90 media in ten families on 28 cages
All checks were successful
CI / Classify the change (pull_request) Successful in 14s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 20s
CI / Server smoke test (pull_request) Successful in 18s
CI / Docker build (pull_request) Successful in 30s
CI / Test (Node 20) (pull_request) Successful in 1m4s
CI / Test (Node 18) (pull_request) Successful in 1m10s
CI / Test (Node 22) (pull_request) Successful in 1m10s
1106839714
README said 89 media types across nine families and 26 connector cages. The engine has carried 90 media in ten families on 28 cages since the serial V.35 medium (#1483) and the CFP2 cage (#1213) landed: Object.keys(require('./engine/media').MEDIA).length is 90, Object.keys(CAGES).length is 28, and the engine's own suites print '90 media' and 'across 28 cages'. The counts were last written at 8e91b60b, when the catalogue really was 89/26/9 - the same numbers PHYSICAL_LAYER.md and SIMULATION.md still carry.
jaylouisw scheduled this pull request to auto merge when all checks succeed 2026-11-16 16:53:02 +00:00
jaylouisw force-pushed docs/1116-1646 from 1106839714
All checks were successful
CI / Classify the change (pull_request) Successful in 14s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 20s
CI / Server smoke test (pull_request) Successful in 18s
CI / Docker build (pull_request) Successful in 30s
CI / Test (Node 20) (pull_request) Successful in 1m4s
CI / Test (Node 18) (pull_request) Successful in 1m10s
CI / Test (Node 22) (pull_request) Successful in 1m10s
to adf81e1318
All checks were successful
CI / Classify the change (pull_request) Successful in 15s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 12s
CI / Test (Node 18) (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Has been skipped
CI / Test (Node 22) (pull_request) Has been skipped
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
2026-11-16 16:53:06 +00:00
Compare
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!1695
No description provided.