aboutsummaryrefslogtreecommitdiffstats
path: root/docs/architecture.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/architecture.md')
-rw-r--r--docs/architecture.md17
1 files changed, 9 insertions, 8 deletions
diff --git a/docs/architecture.md b/docs/architecture.md
index f70f132..f462fe7 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -79,9 +79,9 @@ it switched to the right document without trusting anyone.
**[`transport/`](../src/transport/)** — [`mod.rs`](../src/transport/mod.rs) defines the message types (HELLO, HELLO_REPLY, sync
envelope, STATUS/STATUS_REPLY, PING/PONG, blob messages, PROBE/PROBE_REPLY, REFUSALS, SPEAKS) and the `Transport` trait;
-[`wire.rs`](../src/transport/wire.rs) is the wire format (a version byte, bumped with every change to the format,
-and a kind byte, then the message in MessagePack, derived from the types in [`mod.rs`](../src/transport/mod.rs)
-with codecs for hashes and IDs; SPEAKS, outside the versions, is laid out as no build changes); [`mycelium/`](../src/transport/mycelium/) (with the `mycelium` feature) is the REST
+[`wire.rs`](../src/transport/wire.rs) is the wire format (a version byte, a new version with every change to the format,
+several spoken side by side, and a kind byte, then the message in MessagePack, derived from the types in [`mod.rs`](../src/transport/mod.rs)
+with codecs for hashes and IDs; SPEAKS, WHO and ME, outside the versions, are laid out as no build changes); [`mycelium/`](../src/transport/mycelium/) (with the `mycelium` feature) is the REST
client (polling inbox, outbound POST, one topic, `continuum`, for every message), with
[`mycelium/daemon.rs`](../src/transport/mycelium/daemon.rs) running the daemon (an external one by its URL, or one it starts
and supervises); [`libp2p/`](../src/transport/libp2p/) (with the `libp2p` feature) is libp2p as a transport,
@@ -288,11 +288,12 @@ 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.
-* **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)).
+* **Builds tell each other apart.** Every change of the wire format is a new version; a
+ build speaks several side by side and writes each node the newest both speak, and a
+ node ignores messages of a version it doesn't speak instead of misreading them. Where
+ two releases share none, the swarm is split until every node runs the later, 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