aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/proposing-and-voting.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 11:47:42 +0000
committertv <tv@krebsco.de>2026-11-18 12:58:42 +0100
commitaa77c10a8a20356c277e511e9c6e33c98c9b4104 (patch)
tree78db95e6a178d78746ef7be42166c3591c4a0e15 /docs/guides/federation/proposing-and-voting.md
parent257ad0391ff8eba437108e1885c45314e9fd5833 (diff)
guides: a party writes its node list without a vote
Where a reader adding a node looks (getting started, proposing a version, who syncs), the guides say that a party writes its node list itself, signed with a key its version names, and link to how; a version names a list anew only where its party can't.
Diffstat (limited to 'docs/guides/federation/proposing-and-voting.md')
-rw-r--r--docs/guides/federation/proposing-and-voting.md15
1 files changed, 10 insertions, 5 deletions
diff --git a/docs/guides/federation/proposing-and-voting.md b/docs/guides/federation/proposing-and-voting.md
index 8c9c66f..5330b06 100644
--- a/docs/guides/federation/proposing-and-voting.md
+++ b/docs/guides/federation/proposing-and-voting.md
@@ -1,9 +1,11 @@
# Proposing and voting
-Everything a federation decides is a change of its policy: who the parties are, their
-keys and node lists, who writes where, a checkpoint. A party proposes a version, the
-parties vote, and once two thirds of them back it, it is written. The rules are the
-design's ([`federation.md`](../../federation.md), The policy, Changing the policy).
+Everything a federation decides is a change of its policy: who the parties are, the keys
+they vote with, who writes where, a checkpoint. A party proposes a version, the parties
+vote, and once two thirds of them back it, it is written. The rules are the design's
+([`federation.md`](../../federation.md), The policy, Changing the policy). A party's
+node list and its key set are its own to write, without a vote
+([`common-changes.md`](common-changes.md#what-a-party-does-by-itself)).
## Writing a version
@@ -24,7 +26,10 @@ Then change it:
its `since`; every other keeps the `since` it had, and its keys unchanged. A party left
out is no party any more.
* **`nodes`**: every party's node list, with its `since`, likewise. The version letting a
- party in names its list anew, empty where it gives it no nodes.
+ party in names its list anew, empty where it gives it no nodes. Otherwise a version
+ names a list anew only where its party can't write its own, with a key the current
+ version names for it: a party adds and takes off its nodes by itself
+ ([`common-changes.md`](common-changes.md#what-a-party-does-by-itself)).
* **`rules`**: in order, the first matching a path deciding who writes there
([`writing-and-reading.md`](writing-and-reading.md), Places).
* **`checkpoint`**, only where the version moves the store to a checkpoint: the heads.