aboutsummaryrefslogtreecommitdiffstats
path: root/docs/api.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/api.md')
-rw-r--r--docs/api.md5
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/api.md b/docs/api.md
index a4b76b0..2665306 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -292,7 +292,10 @@ vouched for as the first time; and a node checks one it receives once it holds t
change (a signature costs about 30 µs to check, and one vouches for its node's changes
before it). A message carrying no changes carries no signatures; one carrying more
than 256 signed changes (a whole document pulled) carries each writer's latest among
-them instead, and a delta each writer's latest with changes in it. A writer is a node's
+them instead. Its signatures count towards a message's size, past which its changes are
+offered as a delta (fetched in chunks, from any node holding them); a delta's
+signatures, each writer's latest with changes in it, are a blob of their own, fetched
+from the node that offered it before the changes. A writer is a node's
run: each start, rejoin or drop makes a fresh one. A node signs the latest change of
each of its runs that nothing vouches for as it starts, before anything leaves, and
whenever its document is swapped (a drop, a switch, a rejoin): changes it kept