From b3b84f1f5ba76641cc204b79779563c76ad9de7b Mon Sep 17 00:00:00 2001 From: Garrett Allen <98648590+Gerrrt@users.noreply.github.com> Date: Sat, 29 Aug 2026 06:28:49 +0000 Subject: [PATCH] docs(hardware): put the patch panel back above the PDU The Rack table had U7 as the patch panel and U8 as the PDU. It is the other way round. Confirmed against the rack on 2026-08-29, after this table and the wiki's rack page were found to disagree about exactly these two slots and neither could settle it on paper. Everything else in the table is right, which is what makes this two swapped rows rather than a numbering problem: U1-U2 holds the UPS at the bottom and U9 the switch at the top, so higher U means higher in the rack, and every other row matches what is actually bolted in. Worth stating plainly that nothing was ever at risk. The rack order is load-bearing outside this repository -- the household's printed emergency card says to unplug "the box at the very top" and power-cycle "the 5th box from the top", meaning the switch and morpheus. Neither moves. The swap is between the second and third units, below the top slot and above the fifth, so the count to morpheus is unchanged under either version. Wrong documentation, not a wrong instruction. The correction is recorded under the table rather than applied silently, following the oracle entry in Compute. The two documents disagreed and this one lost; leaving no trace of that invites someone reconciling them again later to swap it back. Nothing in this repository read the order. check_docs.py cross-checks the Compute table against docs/network.md and does not look at the Rack table, and no diagram, runbook or config references the U position of either device. Verified: scripts/check_docs.py passes -- 35 Prometheus + 13 Loki rules, 5 dashboards, 84 panels, 6 assertions -- and markdownlint-cli2 reports 0 issues across 34 files. Closes #162 Co-Authored-By: Claude Opus 5 --- docs/hardware.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/hardware.md b/docs/hardware.md index fe40d38..98fa2e7 100644 --- a/docs/hardware.md +++ b/docs/hardware.md @@ -12,14 +12,20 @@ landfill. | U3 | HPE ProLiant DL360 Gen9[^Shiva] | Proxmox hypervisor (`Saruman`, BMC `shiva`) | | U5 | HP ProDesk 600 G4 Mini[^ProDesk] | pfSense firewall (`morpheus`) | | U6 | MT-VIKI 8-port KVM[^KVM] | Console access | -| U7 | Jadol 24-port patch panel[^Panel] | Cabling | -| U8 | 10-outlet PDU[^PDU] | Power distribution | +| U7 | 10-outlet PDU[^PDU] | Power distribution | +| U8 | Jadol 24-port patch panel[^Panel] | Cabling | | U9 | MokerLink 26-port managed switch[^MokerLink] | Core switching (`neo`) | Off-rack: two Ubuntu Server laptops on a shelf (`prometheus`, `oracle`), an 8-port unmanaged TP-Link switch feeding them, and eero Pro 6E units distributed through the house. +The patch panel and the PDU were listed the other way round here until +2026-08-29. U8 is the panel and U7 is the PDU, confirmed against the rack. +Nothing in this repository depended on the order, but the wiki's rack page had +it right and this table did not, so the correction is recorded rather than +quietly swapped. + ## Compute | Host | Hardware | CPU | RAM | Storage | OS |