diff --git a/nix/host-modules/swarm-otel-service.nix b/nix/host-modules/swarm-otel-service.nix
index edea88cb..6b250ad8 100644
--- a/nix/host-modules/swarm-otel-service.nix
+++ b/nix/host-modules/swarm-otel-service.nix
@@ -79,10 +79,10 @@ in
         and every swarm container shares the host's network namespace. Two
         listeners claiming one port on one host is not a build failure —
         it is a runtime coin toss over which one gets it, with nothing in
-        any log saying so. The same collision cost a release when grafana
-        and the forge both defaulted to 3000. The assertions below check
-        the whole derived range against every port this module and the hive
-        tier declare, which is as far as a module can see.
+        any log saying so. On the host running this collector, an
+        assertion rejects a derived range that overlaps any other port
+        this module or the hive tier declares, which is as far as a module
+        can see.
       '';
     };
 
@@ -132,10 +132,10 @@ in
         ⚠️ Deliberately NOT derived from `port + (number of hives)`: that
         range grows every time a hive is added, and a fixed offset from
         it would silently start colliding once the hive count caught up.
-        Kept as its own reserved value instead, and the assertion below
-        still catches a real collision (including one hive growth
-        eventually causes) rather than starting a collector that quietly
-        drops one receiver's samples.
+        Kept as its own reserved value instead, and the port-collision
+        assertion still rejects a real collision (including one hive
+        growth eventually causes) rather than starting a collector that
+        quietly drops one receiver's samples.
       '';
     };
 
@@ -160,8 +160,8 @@ in
         ⚠️ A reserved value rather than an offset from
         {option}`services.hyperhive.swarm.otel.port`, for the reason stated
         on `producerPort`: that range grows with the hive count and would
-        eventually walk into any fixed offset from it. The collision
-        assertion below covers this port too.
+        eventually walk into any fixed offset from it. The port-collision
+        assertion covers this port too.
       '';
     };