aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/README.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 14:25:53 +0000
committertv <tv@krebsco.de>2026-11-19 15:28:50 +0100
commit5d8259ce576fce47b921c0bfbd6821f255be504a (patch)
treea9979e64cdf03816524f54568588e454baab2688 /docs/guides/federation/README.md
parent841897b79838f97a809356471baf2f41e186cdfa (diff)
docs: how large checkpoints grow, joining before the first, counting support
What the docs left unsaid: * A checkpoint names every event that counts, 32 bytes each, and has no size limit, unlike an event; nothing bounds what a party writes where its rules let it, so every node, snapshot and fork's root holds as much as it writes. A party writing more than the others will hold is taken out by a version, or the others fork. Row 73 says so, and the rules guide. * Before the first checkpoint passed, a node joins from the root and nobody pins anything: a chain of old keys needs keys a version replaced, and a node voting by itself proposes a checkpoint after every version that changes more; until that passes, a joining node takes the first of two versions it judges, as row 63 has it. * A `true` binds; what binds nobody is said outside the votes. The voting guide shows how parties count their support first by plain writes, at a place a rule gives each (`intents/{party}/**`), read at `values` in GET /events/counts.
Diffstat (limited to 'docs/guides/federation/README.md')
-rw-r--r--docs/guides/federation/README.md3
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/guides/federation/README.md b/docs/guides/federation/README.md
index 4c5b33b..104a04c 100644
--- a/docs/guides/federation/README.md
+++ b/docs/guides/federation/README.md
@@ -11,7 +11,8 @@ by them, in its words.
* [`writing-and-reading.md`](writing-and-reading.md): places, values, what counts, why
a write is refused, and signing again after a move.
* [`proposing-and-voting.md`](proposing-and-voting.md): writing a version, proposing it,
- voting by a record, and when a proposal passes or dies.
+ voting by a record, counting support before anyone is bound, and when a proposal
+ passes or dies.
* [`keys.md`](keys.md): the keys a version names and those of a key set, changing them,
and a stolen key.
* [`checkpoints.md`](checkpoints.md): what a checkpoint does, proposing and backing one,