swarm: announce to whom writers can't reach

1 files changed, 4 insertions, 1 deletions

diff --git a/docs/peers.md b/docs/peers.md
index 95b4dab..c63cec1 100644
--- a/docs/peers.md
+++ b/docs/peers.md
@@ -284,7 +284,10 @@ the current pull is answered, if they still have something it lacks. The regular
 STATUS (every third keepalive) triggers the same pull, so gaps close within a few
 keepalive intervals. A node
 that just caught up announces its heads once. In a full mesh nothing is announced: the
-writer reaches everyone (while a node doesn't know its neighbours yet, it announces).
+writer reaches everyone (while a node doesn't know its neighbours yet, it announces);
+but to the neighbours the writer can't reach, those on none of its transports (by the
+member list, the writer's neighbours as this node computes them): a node on Tor and
+libp2p announces to one on Tor alone what came from one on libp2p alone.
 
 ## Keepalive and self-healing