diff options
Diffstat (limited to 'docs/guides/federation')
| -rw-r--r-- | docs/guides/federation/upgrades.md | 20 |
1 files changed, 11 insertions, 9 deletions
diff --git a/docs/guides/federation/upgrades.md b/docs/guides/federation/upgrades.md index 55dd921..f6964a6 100644 --- a/docs/guides/federation/upgrades.md +++ b/docs/guides/federation/upgrades.md @@ -8,16 +8,18 @@ design's ([`federation.md`](../../federation.md), ## Upgrading continuum A node of a federated swarm upgrades as any node does -([`operations.md`](../../operations.md), [Upgrading](../../operations.md#upgrading)): one -at a time, restarted with its files. Across a change of the wire format, upgraded nodes -and the others don't talk, and the swarm is split until all are upgraded; a remake needs -the same Automerge on every node, and one with another rejoins instead of switching. Until -continuum's first release, take every upgrade as such a change. +([`operations.md`](../../operations.md), [Upgrading](../../operations.md#upgrading)), +restarted with its files, and a release's version says how: a patch or a minor release one +node at a time, a major one every node close together. Across a change of the wire +format, a major one, upgraded nodes and the others don't talk, and the swarm is split +until all are upgraded; a remake needs the same Automerge on every node, and one with +another rejoins instead of switching. Before 1.0.0, take every upgrade as a major one. -Nobody runs every node of a federated swarm: each party's operators upgrade its nodes. -Agree on when, among the parties, and upgrade close together. Which wire versions each -node the parties list speaks, as far as a node heard from it, shows in -`GET /events/counts` (`knows`, below: `wire`, the oldest and the newest). +Nobody runs every node of a federated swarm: each party's operators upgrade its nodes. A +patch or minor release each party takes when it likes; for a major one, agree on when, +among the parties, and upgrade close together. Which wire versions each node the parties +list speaks, as far as a node heard from it, shows in `GET /events/counts` (`knows`, +below: `wire`, the oldest and the newest). ## The federation's number and its revision |
