dashboard: human-friendly figures

1 files changed, 8 insertions, 0 deletions

diff --git a/docs/dashboard.md b/docs/dashboard.md
index 4067da5..3a92018 100644
--- a/docs/dashboard.md
+++ b/docs/dashboard.md
@@ -242,6 +242,12 @@ The figures of what is in focus, as a tree: this node's `/admin/stats`, or a pee
 `/peers` entry and links. Branches stay as opened across updates, and ages count on
 between them. What each figure means: [`measurements.md`](measurements.md).
 
+Some values get a reading after them, muted, in parentheses: a node ID its alias
+(where it has one; a key that is a node ID too), a time in Unix milliseconds in RFC 3339
+(a key ending in `At`, `Until` or `Since`, or `at`, `until`, `since`, `alive`), bytes
+in KiB, MiB, GiB (a key ending in `Bytes`, or `bytes`; from 1 KiB), and bytes per
+second likewise (`…BytesPerSec`, `bytesPerSec`).
+
 ## Document
 
 The swarm's document, as this node holds it, its first level open. A branch is read
@@ -262,6 +268,8 @@ to the whole swarm like any other:
 Protocol data (`_continuum`) is written only by users in `--protocol-writers`, and epoch
 metadata and the swarm ID by nobody ([`trust.md`](trust.md)). A key containing `/`, or an empty
 key, is listed but can't be opened.
+In the protocol data, values and keys get the same readings as in the figures: the
+aliases of node IDs (a member's entry, a vote, a coordinator), times and sizes.
 
 ## Console