diff --git a/docs/web-ui/README.md b/docs/web-ui/README.md
index c0af27d2..18fadbf0 100644
--- a/docs/web-ui/README.md
+++ b/docs/web-ui/README.md
@@ -115,8 +115,7 @@ touching the code rather than using the UI:
   [`shape.md`](shape.md) (SSE multiplexing, Worker-death self-heal,
   atomic repaint).
 - **"What does a container row contain?"** →
-  [`dashboard.md`](dashboard.md) (Container row, Topology tree,
-  Selection bar).
+  [`dashboard.md`](dashboard.md) (Container row, Selection bar).
 - **"What endpoints does the dashboard expose?"** →
   [`dashboard.md`](dashboard.md) (Dashboard endpoints, Dashboard event
   channel).
diff --git a/docs/web-ui/dashboard.md b/docs/web-ui/dashboard.md
index 886e1df4..496a398d 100644
--- a/docs/web-ui/dashboard.md
+++ b/docs/web-ui/dashboard.md
@@ -974,12 +974,6 @@ build. (The `hivectl stop --graceful` CLI flag enqueues the same
 `Signal`/`Drain` pair, so the dashboard and CLI paths behave
 identically.)
 
-### Topology tree
-
-Nothing nests. `swarm.js::sortedContainerRows` returns every container
-in alphabetical order, full stop — the SW4RM list is a flat roster, no
-indent, no joint, no continuation bar.
-
 ## Selection bar
 
 Bulk actions (`R3ST4RT` / `ST0P` / `ST4RT` / `P4US3` / `R3SUM3` /
diff --git a/frontend/packages/dashboard/src/swarm.js b/frontend/packages/dashboard/src/swarm.js
index 5281cf80..7ae5c817 100644
--- a/frontend/packages/dashboard/src/swarm.js
+++ b/frontend/packages/dashboard/src/swarm.js
@@ -227,8 +227,7 @@ function derivePortConflicts(containers) {
 }
 
 // ─── container ordering ──────────────────────────────────────────────────────
-// See docs/web-ui/dashboard.md::Topology tree for why this is a flat sort
-// rather than the forest walk it used to be.
+// Flat alphabetical sort — see docs/web-ui/dashboard.md::C0NTAINERS.
 
 function sortedContainerRows(containers) {
   // Close any open context menu before replacing the DOM tree — the