aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/proposing-and-voting.md
diff options
context:
space:
mode:
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.