aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/proposing-and-voting.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 16:25:45 +0000
committertv <tv@krebsco.de>2026-11-19 17:36:31 +0100
commit5f9469e11b09c03d58abafe1f0210b509228315c (patch)
treef5842bc0c44e8bd50e32c86f1210544ee5d63377 /docs/guides/federation/proposing-and-voting.md
parent602718835d034ef0a96c8ca29e47f06ce37008dc (diff)
continuum-party: show, a proposal in words before a vote
A party saw a proposal as its version's JSON changed field by field (`keys.makefu: - -> {"keys":[…],"since":4}`), and voted with nothing more before it. `continuum-party show PROPOSAL` now says what a party votes on, in words (`client::described`): * whether it passed or is dead, who voted what, and how many more `true` pass it; * who proposed it, and the version's number; * the parties it lets in or takes out, with their keys by fingerprint, as `ssh-keygen -l` gives them, and their nodes; the keys and node lists it names anew, with what it adds and drops; * the rules it adds and drops, each where it is among the rules, a rule moved being dropped at one place and added at another; * the checkpoint it moves the store to, and what moving there refuses of what the node took (`beside`); the revision it moves to, and the nodes not known to know it; * the places holding a value whose writer it changes, and why no client backs it, where none does. `proposals` says each proposal so. `vote`, through the node too, says it before anything is cast, then its warnings, and on a terminal asks: `y` casts, anything else casts nothing. Without a terminal, as in a script, it asks nothing.
Diffstat (limited to 'docs/guides/federation/proposing-and-voting.md')
-rw-r--r--docs/guides/federation/proposing-and-voting.md32
1 files changed, 21 insertions, 11 deletions
diff --git a/docs/guides/federation/proposing-and-voting.md b/docs/guides/federation/proposing-and-voting.md
index 739552b..d8410f6 100644
--- a/docs/guides/federation/proposing-and-voting.md
+++ b/docs/guides/federation/proposing-and-voting.md
@@ -196,21 +196,31 @@ curl -s -u tv:secret localhost:3000/events/counts | jq .proposals
# "proposals":["c41e…"],"votes":["5a77…","e019…"],"yes":["tv"]}}
```
-The client shows the same, why it backs one not, by the federation it knows, what each
-proposal's version changes of the current one, field by field and party by party, and
-the places holding a value whose writer it changes (`who writes names/wiki/a: tv ->
-wiki`): admitting a party named as a segment of a place is, or changing the rules or
-their order, moves who writes there, rules unchanged in the first case, and what was
-written there counts no more once it passes:
+The client shows a proposal in words before anyone votes on it (`show`, and `proposals`
+for all of them): whether it passed or is dead, who voted what and how many more `true`
+pass it, who proposed it, and what its version does, not its JSON. That is the parties
+it lets in or takes out, with their keys by fingerprint (as `ssh-keygen -l` gives them)
+and their nodes; the keys and node lists it names anew; the rules it adds or drops, where
+they are among the rules; the checkpoint it moves the store to, and what moving there
+refuses of what the node took; the revision it moves to, and the nodes not known to know
+it. And the places holding a value whose writer it changes (`who writes`): admitting a
+party named as a segment of a place is, or changing the rules or their order, moves who
+writes there, rules unchanged in the first case, and what was written there counts no
+more once it passes. Where no client backs it, it says why, by the federation it knows:
```sh
-continuum-party --node http://tv:secret@localhost:3000 proposals
-# 8d02…: dead; true: tv; false: lass
-# changes: null -> "1f4c…"
-# checkpoint: - -> ["4a1d…","9e30…"]
-# number: 0 -> 1
+continuum-party --node http://tv:secret@localhost:3000 show 8d02
+# 8d02…: can still pass, 1 more `true` passing it (3 of 4); true: tv, lass; false: nobody
+# proposed by tv: version 2 on 1
+# lets makefu in: 1 key (ssh-ed25519 SHA256:IDPEVCc1gUXL…); 1 node (continuum:e2a8f0c1d9b3…)
+# adds rule 1: names/r/wiki -> lass
+# who writes names/r/wiki: tv -> lass
```
+`vote` says the same before it casts anything, then its warnings, and, on a terminal,
+asks before it casts: answer `y` to cast, anything else to cast nothing. In a script,
+with no terminal, it asks nothing.
+
A node's dashboard shows them so too, and where the node votes for its party by itself,
votes through it ([`dashboard.md`](../../dashboard.md),
[Federation](../../dashboard.md#federation)).