diff options
| author | tv <tv@krebsco.de> | 2026-11-17 13:49:19 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-17 15:04:13 +0100 |
| commit | 4bc653a9f81e2b22fd45eb8481ca4b3e122db28a (patch) | |
| tree | 5afab41eedb9420f3c537d653aec656b7c16ee43 /docs | |
| parent | c0b1835d226db63a1504b3c751b30d0f6369e4ad (diff) | |
guides: a version begun from the current one leaves out its checkpoint
The current version may name a checkpoint, whose heads are behind: a version naming them
again is never written. Writing a version leaves it out unless the version moves the
store on.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/guides/federation/proposing-and-voting.md | 4 |
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 |
