aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/dashboard.md4
-rw-r--r--docs/openapi.yaml5
2 files changed, 6 insertions, 3 deletions
diff --git a/docs/dashboard.md b/docs/dashboard.md
index d39022d..a93e4d4 100644
--- a/docs/dashboard.md
+++ b/docs/dashboard.md
@@ -285,7 +285,9 @@ are done. The map isn't redrawn under the pointer: what you point at stays put.
built with `dashboard` (404), or the user isn't in `--htpasswd` (401).
* **A hollow node**: no links report from it. If it is also dormant here, it is
probably down or unreachable; if not, it may not take this node for a member yet
- (it hasn't registered it), or its answers don't arrive.
+ (it hasn't registered it), or its answers don't arrive. A node that just joined
+ through others shows as soon as one of them reports a link to it, hollow until its
+ registration reaches this node and it is asked for its links (within 30 s).
* **Only dashed grey between two nodes**: the member list wants them as neighbours, but
neither reports a link to the other: they haven't reached each other (yet).
* **A dotted link**: one end has stopped reporting; the link is as it was last
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 8ffc8d7..387a7ac 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -748,8 +748,9 @@ paths:
description: |
The dashboard's latest snapshot: `node` (`id`, `alias`), `page` (the page's
version, a hash: a page showing another reloads), `stats` (as
- `/admin/stats`), `peers` (as `/peers`) and `graph`: `members` (by node ID:
- `alias`, `self`, `dashboard`: its `--dashboard-url`), `intended` (by node ID: the neighbours the member list gives
+ `/admin/stats`), `peers` (as `/peers`) and `graph`: `members` (by node ID,
+ those of the member list, and any a link reported goes to: `alias`, `self`,
+ `dashboard`: its `--dashboard-url`), `intended` (by node ID: the neighbours the member list gives
it, as this node computes them), `measured` (by node ID: `secsAgo` and
`links`, each with `peer`, `transport`, `relayed`, `down`, `rttMs`, `dormant` and
`others` (the peer's other transports: `transport`, `rttMs`, `relayed`), as the member