diff options
| author | tv <tv@krebsco.de> | 2026-11-16 04:17:57 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-16 04:17:57 +0000 |
| commit | 8029b408b7e33bfd429c9b0cb2ac5412afda3bcc (patch) | |
| tree | 5ccc26c0f26ac7afe99ca26af6743080cb3cd822 | |
| parent | 71ac2362820ca0b1ff6911b9b269261496d4b478 (diff) | |
docs: the strict remake among the kinds
The glossary and the `kind` row of `remakes.md` named three kinds of
remake; `strict` is the fourth, and takes `baseHeads` as `replace` and
`import` do.
| -rw-r--r-- | docs/glossary.md | 3 | ||||
| -rw-r--r-- | docs/remakes.md | 4 |
2 files changed, 4 insertions, 3 deletions
diff --git a/docs/glossary.md b/docs/glossary.md index fd165f1..5497b57 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -133,7 +133,8 @@ swarm (started with `--genesis`, empty or with content from `--remake`). **remake**: a coordinated move of the whole swarm to a new epoch. Kinds: **compact** (same content, no history), **replace** (new content as JSON), -**import** (new content as an Automerge document). +**import** (new content as an Automerge document), **strict** (as compact, turning the +swarm strict, keeping only the signed values an operator's manifest names). **base**: the heads the new epoch's content accounts for. Writes made after them are carried over into the new epoch (**replayed**), at their path or where the remake's diff --git a/docs/remakes.md b/docs/remakes.md index 2d887d5..5a12873 100644 --- a/docs/remakes.md +++ b/docs/remakes.md @@ -93,9 +93,9 @@ curl -X POST localhost:3000/admin/remakes -H 'Content-Type: application/json' -d | Field | Default | Meaning | |---|---|---| -| `kind` | `compact` | `compact`, `replace` or `import`. | +| `kind` | `compact` | `compact`, `replace`, `import` or `strict`. | | `spec` | none | The kind's input (below). | -| `baseHeads` | current heads | `replace` and `import` only: what the new document accounts for; writes after it are carried over. | +| `baseHeads` | current heads | `replace`, `import` and `strict` only: what the new document accounts for; writes after it are carried over. | | `settle` | 8 × keepalive | Voting period, a duration ([`configuration.md`](configuration.md), "Durations and sizes"). A short one only risks an abort for lack of votes. | | `switchDelay` | 1 × keepalive | Wait between commit and switch, so the commit reaches every node first. Shorter only with `?force=switchDelay`. | | `replayWindow` | 1 epoch, 7 days | How far behind a returning node may be and still have its writes carried over automatically. A remake's snapshot keeps an earlier epoch's metadata (`_continuum/epochs`) only while that still covers a node on the epoch before, and a strict remake's for good. | |
