aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/README.md
blob: 6a0cd1e6b9b2a1b34cc6b6bfa3a0850d47ea7e07 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Guides to a federated swarm

How to start, run and use a swarm kept by parties that don't trust each other. The design
([`federation.md`](../../federation.md)) says what the rules are; these say how to live
by them, in its words.

* [`getting-started.md`](getting-started.md): two parties start a federation, write,
  read, and let a third one in.
* [`running-a-node.md`](running-a-node.md): a node's options and files, who syncs, what
  its API lets in, and joining.
* [`writing-and-reading.md`](writing-and-reading.md): places, values, what counts, why
  a write is refused, and signing again after a move.
* [`proposing-and-voting.md`](proposing-and-voting.md): writing a version, proposing it,
  voting by a record, and when a proposal passes or dies.
* [`keys.md`](keys.md): the keys a version names and those of a key set, changing them,
  and a stolen key.
* [`checkpoints.md`](checkpoints.md): what a checkpoint does, proposing and backing one,
  signing again after a move, and nodes that weren't there.
* [`when-things-go-wrong.md`](when-things-go-wrong.md): a version a node refused, a party
  that voted twice, choosing a side, and a node doing less than it should.
* [`forking-and-following.md`](forking-and-following.md): when to fork, making and
  checking a fork, and following one.
* [`promises.md`](promises.md): what holds whatever the parties do, what doesn't, and
  what that asks of a party, an operator and an application.
* [`common-changes.md`](common-changes.md): the next version, and recipes for letting a
  party in, taking one out, giving places, zones and blocks, and keys named anew.