docs(schema): the passive poeOutClass census is 109 ports across 37 specs, not 94/35 #2454

Merged
jaylouisw merged 1 commit from docs/1121-1717 into main 2026-11-21 17:38:50 +00:00
Owner

What was untrue

docs/DEVICE_SCHEMA.md ("The class is a record, not a rule") said:

It is wider than the four standards today - 269 ports declare PoE+++ (devices/ubiquiti/ecs-24-poe.json), 94 across 35 specs declare passive (devices/ubiquiti/uisp-r.json), and 34 write the parenthesised PoE+ (802.3at).

The sentence was counted at 2482ba7a (#2357) and three device PRs have landed since, each adding real passive-PoE sockets to the catalogue.

Evidence

Counting poeOutClass === 'passive' over the loaded catalogue (loadCatalog('devices'), interfaces[]), the same way the 94/35 figure was produced:

  • at 2482ba7a: 94 ports across 35 specs (matches the page, so the method is the page's own)
  • at today's main: 109 ports across 37 specs

The delta is entirely passive sockets added by:

spec passive ports PR
devices/mikrotik/css106-1g-4p-1s.json 0 -> 4 (new spec entry) #2415
devices/ubiquiti/n-sw.json 0 -> 3 (new spec entry) #2431
devices/ubiquiti/es-16xp.json 8 -> 16 #2433

269 ports declare PoE+++ and 34 write PoE+ (802.3at) are still exact today and are left alone; ecs-24-poe.json (24 PoE+++ ports) and uisp-r.json (8 passive ports) still illustrate their rows.

Change

One line, numbers only: 94 across 35 specs -> 109 across 37 specs. No prose, no code, no features.

Gates

  • node scripts/syntax-check.js: 541 files, all OK
  • docs-cli-transcript 9/9, docs-show-commands 7/7, help-completeness 8/8, no-form-help-key 81/81, help-key-is-not-a-value 40/40, help-key-works-in-every-prompt 10/10
  • scripts/check-doc-citations.js: 380 citations, 25 judged, none >40 lines from its symbol
  • doc-catalog-counts: 43/43 (unaffected; that guard covers DEVICE_REGISTRY.md's vendor/model totals)

Guards before and after this change are identical - it is prose, and no guard reads these counts (which is why they drifted).

Not done

No guard was added for this census; docs/plans/doc-counts.md proposes one and this stream is docs-only.

## What was untrue `docs/DEVICE_SCHEMA.md` ("The class is a record, not a rule") said: > It is wider than the four standards today - 269 ports declare `PoE+++` (`devices/ubiquiti/ecs-24-poe.json`), **94 across 35 specs declare `passive`** (`devices/ubiquiti/uisp-r.json`), and 34 write the parenthesised `PoE+ (802.3at)`. The sentence was counted at `2482ba7a` (#2357) and three device PRs have landed since, each adding real passive-PoE sockets to the catalogue. ## Evidence Counting `poeOutClass === 'passive'` over the loaded catalogue (`loadCatalog('devices')`, `interfaces[]`), the same way the 94/35 figure was produced: - at `2482ba7a`: 94 ports across 35 specs (matches the page, so the method is the page's own) - at today's `main`: **109 ports across 37 specs** The delta is entirely passive sockets added by: | spec | passive ports | PR | |---|---|---| | `devices/mikrotik/css106-1g-4p-1s.json` | 0 -> 4 (new spec entry) | #2415 | | `devices/ubiquiti/n-sw.json` | 0 -> 3 (new spec entry) | #2431 | | `devices/ubiquiti/es-16xp.json` | 8 -> 16 | #2433 | `269 ports declare PoE+++` and `34 write PoE+ (802.3at)` are still exact today and are left alone; `ecs-24-poe.json` (24 `PoE+++` ports) and `uisp-r.json` (8 `passive` ports) still illustrate their rows. ## Change One line, numbers only: `94 across 35 specs` -> `109 across 37 specs`. No prose, no code, no features. ## Gates - `node scripts/syntax-check.js`: 541 files, all OK - `docs-cli-transcript` 9/9, `docs-show-commands` 7/7, `help-completeness` 8/8, `no-form-help-key` 81/81, `help-key-is-not-a-value` 40/40, `help-key-works-in-every-prompt` 10/10 - `scripts/check-doc-citations.js`: 380 citations, 25 judged, none >40 lines from its symbol - `doc-catalog-counts`: 43/43 (unaffected; that guard covers DEVICE_REGISTRY.md's vendor/model totals) Guards before and after this change are identical - it is prose, and no guard reads these counts (which is why they drifted). ## Not done No guard was added for this census; `docs/plans/doc-counts.md` proposes one and this stream is docs-only.
docs(schema): the passive poeOutClass census is 109 ports across 37 specs (#2452)
All checks were successful
CI / Server smoke and Docker build (pull_request) Successful in 9s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 8s
CI / Test (Node 20) (pull_request) Successful in 1m2s
CI / Test (Node 22) (pull_request) Successful in 1m2s
CI / Test (Node 18) (pull_request) Successful in 1m5s
CI / Arm auto-merge (pull_request) Successful in 3s
55783bb5be
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-21 17:21:31 +00:00
forgejo-actions canceled auto merging this pull request when all checks succeed 2026-11-21 17:30:54 +00:00
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!2454
No description provided.