aboutsummaryrefslogtreecommitdiffstats
path: root/docs/architecture.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/architecture.md')
-rw-r--r--docs/architecture.md7
1 files changed, 5 insertions, 2 deletions
diff --git a/docs/architecture.md b/docs/architecture.md
index 202495d..f70f132 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -288,8 +288,11 @@ places that rely on it.
* **Conflicts are errors; overrides are named.** A contradiction in the configuration
or at the API refuses with a message that names the `force` value that would
override it, in one camelCase vocabulary everywhere.
-* **Wire formats grow by appending.** New fields default when absent, so a swarm can
- be upgraded one node at a time (until the first release lifts that constraint).
+* **Builds tell each other apart.** Every change of the wire format bumps its version,
+ and a node ignores messages of another version instead of misreading them: across a
+ change, the swarm is split until every node runs it, and merges then. A release's
+ version says whether it is such a change ([`operations.md`](operations.md),
+ [Upgrading](operations.md#upgrading)).
## Where the complexity sits