Say rollout, not walk, for the sending of a batch across nodes (issue 646)

00-META/glossary.md

@@ -178,7 +178,7 @@ every other domain has something to run on. **Recorded by** the controller and t
   (ADR 0229).
 
 - **record mirror** — a key-value bucket on the bus that the controller writes from one kind of its
-  records (nodes, assignments, walks, builds, settings), after each change commits in its store and only
+  records (nodes, assignments, rollouts, builds, settings), after each change commits in its store and only
   when the value differs, with one event per write. The store stays the record; the self-check compares
   the two and raises `mirror-drifted` on any difference
   (ADR 0289). Shortened to *mirror* where the
@@ -306,7 +306,7 @@ and the operator act. **Recorded by** the controller's `identity` and `licences`
 
 **Purpose.** To take one commit from its pull request to every node that should run it, and to put it
 back when it fails. **Recorded by** the `mesh-delivery` module (deliveries) and the controller (the
-planner, the walk). **Downstream of** Module, Core, Health and repair and Data.
+planner, the rollout). **Downstream of** Module, Core, Health and repair and Data.
 **Decided by** ADR 0162, 0218, 0236, 0237, 0238, 0239, 0250, 0267, 0270, 0276, 0323.
 **Uses:** module, node, declaration and send (Placement), health (Health and repair), person.
 
@@ -348,7 +348,7 @@ planner, the walk). **Downstream of** Module, Core, Health and repair and Data.
 - **delivery** — one commit in one repository on its way to the nodes, from its pull request's head
   being announced to one of its final states: one pull request, one status, one note
   (ADR 0239).
-  From its merge on it is delivered by the walk of the batch that answers it, and ends with that walk
+  From its merge on it is delivered by the rollout of the batch that answers it, and ends with that rollout
   (ADR 0276).
   Its states are one table (`proposed`, `checked`, `ready` or `rejected`, `published`, `delivering`,
   `held`, and the final six: `delivered`, `failed`, `superseded`, `stopped`, `retired` and `covered`;
@@ -357,9 +357,9 @@ planner, the walk). **Downstream of** Module, Core, Health and repair and Data.
   mechanism, which the as-is designs describe; it is never a word for a delivery.
   *Not:* ~~deployment~~ (hq)
 - **covered** — the end of a delivery that a later merge containing it delivered: every module it moves was
-  sent to every machine running it by the walk of a later merge into the same trunk, delivered on its own
+  sent to every machine running it by the rollout of a later merge into the same trunk, delivered on its own
   passing check, whose merge commit the forge says contains this one. Not *superseded*, which is a delivery
-  whose walk a newer delivery took over before it ended; nor *delivered*, which its own walk or an empty plan
+  whose rollout a newer delivery took over before it ended; nor *delivered*, which its own rollout or an empty plan
   ends in (ADR 0270).
 - **delivery group** — two or more deliveries sharing a pull request head branch name across the mesh's
   repositories, delivered as one unit in an order declared (`after:`) or inferred by the planner. One
@@ -372,18 +372,18 @@ planner, the walk). **Downstream of** Module, Core, Health and repair and Data.
 - **merge window** — the rolling wait in which the controller collects merges before it plans them: each
   merge restarts it, and it closes when none arrived for its length (90 seconds by default) or at the latest
   10 minutes after its first merge (ADR 0276).
-- **batch** — the merges one merge window collected, planned once as one walk. For a repository merged more
-  than once in it, the walk takes the latest commit, and the earlier merges are answered by it. Not *group*,
+- **batch** — the merges one merge window collected, planned once as one rollout. For a repository merged more
+  than once in it, the rollout takes the latest commit, and the earlier merges are answered by it. Not *group*,
   which is a delivery group.
 - **mesh-delivery** — the module that owns deliveries and delivery groups, holding the mesh-scoped seat
   of the same name. It records and decides; the controller sends, judges and rolls back when it is asked.
-- **walk** — the controller's sending of one batch's builds across nodes, at most one trunk commit per
+- **rollout** — the controller's sending of one batch's builds across nodes, at most one trunk commit per
   repository, tier by tier, one node first and judged at the first-node gate, then the rest (ADR 0236,
-  ADR 0276). One walk is open at a time; it names every merge it answers. A primitive the delivering stage
-  asks for, not an object anyone manages. A **tier** is one step of a walk: a module, then the modules
-  built against it. The controller's verb `plans` lists the walks. Walking is not a noun of its own:
-  a module *rolls out* by its `roll` policy.
-  *Not:* ~~rollout~~ (hq)
+  ADR 0276). One rollout is open at a time; it names every merge it answers. A primitive the delivering stage
+  asks for, not an object anyone manages. A **tier** is one step of a rollout: a module, then the modules
+  built against it. The controller's verb `plans` lists the rollouts. A module is rolled out by its `roll`
+  policy.
+  *Not:* ~~walk~~ (hq)
 - **first-node gate** — the judgement on a delivery's first node: healthy three times, no witness put it
   back, no condition raised since the send (ADR 0236 §2). Not *the gate* bare (see [Homonyms](#homonyms)).
 - **core module** and **leaf module** — a core module is one on the controller's own path (the controller,
@@ -394,7 +394,7 @@ planner, the walk). **Downstream of** Module, Core, Health and repair and Data.
   the core modules add mesh-delivery and the resolver.
 - **delivery time** — from a delivery's merge to every node of its deploy plan that is heard from running its
   modules' builds and reporting them healthy. Its **delivery budget** is what it is held to: three minutes for
-  a leaf module (ADR 0304), ten for a core module (ADR 0282). Not the walk's time, which ends at the send. A
+  a leaf module (ADR 0304), ten for a core module (ADR 0282). Not the rollout's time, which ends at the send. A
   measure inside the fix budget, not the operator's target (ADR 0313).
 - **fix time** — from an issue's first move to `fixing` to the moment the last of its fixes is delivered: the
   operator's measure of a fix, the agent's work, the review and the checks included, the delivery time its last
@@ -672,7 +672,7 @@ renaming one sense, the old sense moves to a *Not:* line and becomes mechanical.
 |---|---|---|---|
 | plan | what the controller would send one node | that node's **declaration** (verb `plan`) | Placement |
 | | what a delivery would do to the mesh | **delivery plan** | Change and delivery |
-| | the sending of one batch of commits across nodes | **walk** (verb `plans`) | Change and delivery |
+| | the sending of one batch of commits across nodes | **rollout** (verb `plans`) | Change and delivery |
 | | a step a person starts, like the bus's | **planned step** | Core |
 | membership | the subjects a bus account is issued | **membership** | Provisioning |
 | | an account in a group of the machine | **account group** | Placement |
@@ -686,7 +686,7 @@ renaming one sense, the old sense moves to a *Not:* line and becomes mechanical.
 | | the pull request status | **merge gate** | Change and delivery |
 | | a failed step stopping its module's later steps (ADR 0136) | *a failed step holds its module* | Placement |
 | tier | a level of the mesh | **layer** | Core |
-| | a step of a walk | **tier** | Change and delivery |
+| | a step of a rollout | **tier** | Change and delivery |
 | | how much proof an ask needs | **assurance level** | Identity and access |
 | ask | a request for the operator's input | **ask** | Operator and conversation |
 | | an entry in the build queue | **build request** | Change and delivery |