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) says what the rules are; these say how to live
by them, in its words.
getting-started.md: two parties start a federation, write, read, and let a third one in.running-a-node.md: a node's options and files, who syncs, what its API lets in, and joining.writing-and-reading.md: places, values, what counts, why a write is refused, and signing again after a move.proposing-and-voting.md: writing a version, proposing it, voting by a record, and when a proposal passes or dies.keys.md: the keys a version names and those of a key set, changing them, and a stolen key.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: 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: when to fork, making and checking a fork, and following one.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: the next version, and recipes for letting a party in, taking one out, giving places, zones and blocks, and keys named anew.voting-by-itself.md: a node voting and proposing for its party by its operator's rules: its key, its record, following, proposing checkpoints.refusals-and-drops.md: what a node refuses and what of it is its own, the store file, dropping events and taking them back.remakes.md: compactions only, the electorate, the snapshot, putting again after a switch, two epochs for one, and rejoining.upgrades.md: upgrading the nodes of a federated swarm, and what the federation's number says.watching.md: what a node's API and its log say that needs an operator or a party.building-on-the-api.md: an application reading what counts and writing as a party, through the client or with code of its own.designing-rules.md: how rules match, namespaces, zones and blocks, what is nobody's by its spelling, what rules cost, and the krebs registry's.
