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.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/guides/federation/proposing-and-voting.md b/docs/guides/federation/proposing-and-voting.md
index 926955f..ee9a46a 100644
--- a/docs/guides/federation/proposing-and-voting.md
+++ b/docs/guides/federation/proposing-and-voting.md
@@ -8,7 +8,7 @@ design's ([`federation.md`](../../federation.md), The policy, Changing the polic
## Writing a version
A version is the whole policy, not a change to it. Begin from the current one, as a node
-shows it:
+shows it ([`common-changes.md`](common-changes.md) does the first steps below in one):
```sh
curl -s -u tv:secret localhost:3000/events/counts | jq .version.version > next.json
@@ -28,6 +28,8 @@ Then change it:
* **`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.
+ Otherwise leave it out, though the current version names one: its heads are behind,
+ and a version naming them again is never written.
Party names are 1 to 64 of `A-Z a-z 0-9 . _ @ -`; a party has up to 16 keys and 64
nodes; a rule's path is a path as a write's is, its first segment literal and not