diff options
| -rw-r--r-- | docs/federation.md | 28 |
1 files changed, 14 insertions, 14 deletions
diff --git a/docs/federation.md b/docs/federation.md index 39b9bbe..f393705 100644 --- a/docs/federation.md +++ b/docs/federation.md @@ -895,9 +895,9 @@ What to weigh in a list: more than two thirds of all of them. One that never votes stands in the way like one voting against. With a third of them not voting nothing is decided, a list naming others neither. -* So a list names those who take part: recommended, the users who voted or signed - anything in the epoch, which a client makes from the document. All users may be - on it; in a registry of many of whom few care, that is the last thing decided. +* So a list names those who take part: recommended, the users who voted, or signed + anything that stands, which a client makes from the document. All users may be on + it; in a registry of many of whom few care, that is the last thing decided. * A swarm names its voters anew while two thirds of them still take part. Past that, those left go apart, naming who votes among them (Going apart). So that the line is seen coming, `GET /registry/decisions` shows for each voter when it last voted and @@ -921,11 +921,12 @@ voted on, they propose again to those who vote now. 1. A voter **proposes**: a statement naming its matter and what is to hold. A matter is one thing that can be one way only: one number, the rest of the policy, one - user's first keys, one name. The proposals of a matter are numbered: each has, and - states, the number after the highest of its matter that it was signed in sight - of. Any number of proposals are open at a time, on one matter too; - `limits.proposals` of one voter's at most. A proposal is open until it is decided, - its proposer releases it, or one of its matter with a higher number is decided. + user's first keys, one name, who votes, who the roots are. The proposals of a + matter are numbered: each has, and states, the number after the highest of its + matter that it was signed in sight of. Any number of proposals are open at a time, + on one matter too; `limits.proposals` of one voter's at most. A proposal is open + until it is decided, its proposer releases it, or one of its matter with a higher + number is decided. 2. Voters **vote** for it: each a statement signed by the user, saying when the vote runs out, `window` from signing unless the user says sooner; a node counts no vote for longer than `window` from when it first held it. A voter has one vote on a @@ -989,11 +990,10 @@ the changes a node holds: a limit that was lowered leaves out what is past it, wherever that was signed. Every node acts on the decision that holds, the same from the same changes, unless it refuses it (Refusing a decision). -**By any node.** A proposal, a vote and their release are taken in any node's change: -the signature is the voter's. So a voter votes at whatever node it reaches, or signs -a vote that someone carries to one. A vote kept back counts while it runs, as its -signer wrote, and no longer. What brings a vote from a person to a node (a client, a -page, paper) is the application's. +**By any node.** As any statement, a vote is taken in any node's change: a voter votes +at whatever node it reaches, or signs a vote that someone carries to one. A vote kept +back counts while it runs, as its signer wrote, and no longer. What brings a vote from +a person to a node (a client, a page, paper) is the application's. **From the past.** Votes kept back until they ran out, or crafted to look old, are held while they run by no honest node, so nothing takes their proposal up but its @@ -2398,7 +2398,7 @@ Decisions and remakes: | 115 | A version builds another snapshot from a remake's base | Its node gets another ID than the remake was committed for, stays, and says so: two IDs for one base show | 2 | sim: `a_remake_by_its_result` | | 116 | A decision on the roots names its proposer the only root, or leaves a root out; the root left out signs on as one, and its node witnesses on | The voters see whom a proposal names before they vote for it. A root is one where the decision naming it holds, read where each thing it did was done: what it signs after it is left out is an ordinary user's, its node's changes after witness as no root's, and it is out unless someone vouches for it | 7 | unit: `roots_by_a_decision`, `a_root_where_it_is_one` | | 117 | With the keys of two thirds of voters since replaced, stolen later, makes up a decision of then; or a list of voters of its own, with the number of the one that replaced them and a lower digest | What voters that others replaced decide counts only in sight of the proposal that replaced them: the first decides nothing. The second holds only until the list it would replace is final: no decision of its matter proposed out of sight of a final one holds | 7; not promised before final | unit: `the_voters_before`, `a_final_decision` | -| 118 | Two thirds of the voters turn on the rest | They name the roots and who votes, remake, set any number (a share of the voters that lets one decide for all), change the policy, give a user's first keys to another, deal with the names of a user that is out, and say whose a contested name is: a name taken, in the open. They forge no signature and move nobody to other rules; the rest refuse, or fork | not promised | argued (Going apart, Refusing a decision) | +| 118 | Two thirds of the voters turn on the rest | They name the roots and who votes, set any number (a share of the voters that lets one decide for all), change the policy, give a user's first keys to another, deal with the names of a user that is out, and say whose a contested name is: a name taken, in the open. They forge no signature and move nobody to other rules; the rest refuse, or fork | not promised | argued (Going apart, Refusing a decision) | | 119 | Offers a statement signed on the other side of a fork | Refuse: it names its epoch | 3 | unit: `signed_for_its_user_id_and_epoch` | | 120 | A fork naming its proposer the only voter and root | A node follows only by its operator's word, which names the proposal; what that says shows | 7 | sim: `a_fork_by_choice` | | 121 | A decision breaks a node's bounds: the voters let one of them decide for all | The node refuses it and moves to the epoch built without it, the same for every node that refuses, with what it held: they go on together | 7 | unit: `bounds_on_the_numbers`; sim: `those_who_refuse_meet` | |
