aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/guides/federation/when-things-go-wrong.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/guides/federation/when-things-go-wrong.md b/docs/guides/federation/when-things-go-wrong.md
index b59b69b..7c814c2 100644
--- a/docs/guides/federation/when-things-go-wrong.md
+++ b/docs/guides/federation/when-things-go-wrong.md
@@ -75,10 +75,16 @@ nothing by itself or by hand; what is put through it, it still writes into the d
can't judge`), and `GET /events` names the event, why, and how many it holds back:
```sh
-curl -s -u tv:secret localhost:3000/events | jq .stopped
-# {"heldBack":12,"id":"9a1e…","why":"version 3c0f… passed, and doesn't read as one…"}
+curl -s -u tv:secret localhost:3000/events | jq -r .stopped.why
+# version 3c0f… passed, and doesn't read as one here: of federation 2, and this
+# continuum knows 1 alone
```
+`why` says what doesn't read: a federation this continuum doesn't know, a field it
+doesn't know, by its name, a key of a type it doesn't take, or whatever else makes a
+version none ([`proposing-and-voting.md`](proposing-and-voting.md),
+[Writing a version](proposing-and-voting.md#writing-a-version)).
+
Upgrade the node to a continuum that reads it: restarted, it reads its store anew and
takes it. Where none does (two thirds passed a proposal that is no version), have the node
drop that event: it goes on under the version before, refuses the event and any writing