diff --git a/docs/swarm/README.md b/docs/swarm/README.md
index 57e8677e..32b6cbed 100644
--- a/docs/swarm/README.md
+++ b/docs/swarm/README.md
@@ -484,9 +484,9 @@ To check it's working, push to `internal/knowledge` and look for
 `webhook: verified delivery` in `journalctl -u swarm-controller`. A
 refused delivery logs `webhook: refused delivery` with the reason.
 
-The controller registers the hooks as soon as it has both the forge token and
-the secret, and keeps trying, at most five minutes apart, for as long as the
-forge or the secret store is down. A restart isn't needed to recover.
+The controller registers the hooks within five minutes of having both the forge
+token and the secret. It keeps trying, at most five minutes apart, for as long
+as the forge or the secret store is down. A restart isn't needed to recover.
 
 ## Hives: the substrate