Skip to content

Agent Mesh

docs: a node dials a transit router to reach a peer behind it

Tomas Tormo9ad6c6417354
diff --git a/site/content/docs/concepts/networking.md b/site/content/docs/concepts/networking.md
index b3dd9501..54d575ce 100644
--- a/site/content/docs/concepts/networking.md
+++ b/site/content/docs/concepts/networking.md
@@ -58,7 +58,9 @@ on the routers closest to its key, which it finds in the Kademlia table
the routers keep among themselves. A node that looks for a service, or
for a peer, asks a router it holds, and the router answers from its own
records and from those closest routers. A node keeps no DHT of its own
-and connects to no router it does not hold. It re-announces every
+and asks only the routers it holds. A node connects to another router only
+to reach a peer behind that router, as [Connecting](#connecting) describes.
+It re-announces every
reprovide interval of the mesh (`/info`), withdraws a record when it
stops the service or leaves, and a record a provider stopped announcing
without withdrawing it leaves the directory after three intervals.
diff --git a/site/content/docs/guides/scalability.md b/site/content/docs/guides/scalability.md
index 3f13ae00..87220d8b 100644
--- a/site/content/docs/guides/scalability.md
+++ b/site/content/docs/guides/scalability.md
@@ -27,7 +27,8 @@ providers and peers. The router keeps the member's records, places each
on the routers closest to its key (three, the mesh's replication,
`agentmesh-control-plane --dht-replication`), and answers each lookup
from its own records and those routers', asked at once. The member keeps
-no DHT and connects to no router it does not hold. It re-announces every
+no DHT and asks only the routers it holds. It connects to another router
+only to reach a peer behind that router. The member re-announces every
5 minutes (the mesh's `--dht-reprovide-interval`) and withdraws a record
when it stops the service or leaves. A member connects to another member only to
call it, through that member's router, where it runs the credential
diff --git a/site/content/docs/reference/router.md b/site/content/docs/reference/router.md
index d78ef02f..a087a8cd 100644
--- a/site/content/docs/reference/router.md
+++ b/site/content/docs/reference/router.md
@@ -90,7 +90,8 @@ replica count.
withdraws them from the same routers. A member asks for providers of
a key or for a peer; the router answers from its own records and from
the routers closest to the key, asked at once. A member keeps no DHT
- and connects to no router it does not hold.
+ and asks only the routers it holds. It connects to another router only
+ to reach a peer behind that router.
6. Refreshes its own credential before it expires, like a node, at the
pass that finds less than a fifth of its lifetime left.
7. Every 5 seconds, compares the members it holds, the peers that passed