substitutes held longer

1 files changed, 3 insertions, 2 deletions

diff --git a/docs/peers.md b/docs/peers.md
index 79f2abb..85d65a9 100644
--- a/docs/peers.md
+++ b/docs/peers.md
@@ -365,8 +365,9 @@ its registry entry ([`swarm/working_links.rs`](../src/swarm/working_links.rs), `
 its neighbours by the graph it doesn't reach (`unreached`), once down for four keepalive
 intervals, and its neighbours it reaches that the graph doesn't link it to (`reached`:
 a ring going round a member it doesn't reach, a member reaching out from behind NAT),
-once up for one; each comes out again after the
-other hold; a link the other end records as unreached already isn't recorded again.
+once up for four too (a ring goes round a member only while it is away, so a short
+absence writes nothing); a link back comes out after one keepalive, a substitute gone
+after four; a link the other end records as unreached already isn't recorded again.
 On a stable swarm the entry has none. A member that went away is recorded
 as unreached by its neighbours (they can't tell it from a link that broke), and taken
 out once they reach it again: so a node first asks up to three