DOWNTIME PRESSAN INTERACTIVE ESSAYS

Distributed systems · learned by breaking them

The Shelf.

Twelve essays to a shelf, every spine live. Each ships with a live machine inside — a cluster you can partition, a cache you can melt, a door you can burst — because the series has exactly one teaching method: put the failure in your hands. Whiteboard answers evaporate; scar tissue doesn't. Pick a spine.

12 ESSAYS · 40 LIVE FIGURES · 36 QUESTIONS

the shelf, abridged — arc 01 of 15 · “the shelf begins.”

OPEN THE MAP
№ 01THE MAP

Twelve spines, fifteen debts.

The shelf reads left to right in the order it was written — which turns out to be the order it should be read: state (The Cap), then change (The Ring), then coordination (The Lock), then the two wires (The Cache, The Ack). Everything after stands on something before, and the arcs above the shelf are that debt made visible. Fifteen of them — each a sentence one essay literally says about another. The longest jump is № 03 to № 11: the coordinator The Lock killed comes back in The Vote as a crown anyone may wear. And the newest spine, THE BUCKET, is the one the others had been knocking on all along: three of them — The Cache, The Ack, The Feed — turn out to have been describing its door. Hover a spine to trace its debts; click to open the essay.

FIG. 01 — THE SHELF · 12 SPINES, 15 ARCSHOVER TO TRACE · CLICK TO OPEN

the map is the honest dependency graph — every arc quotes a sentence the later essay actually says. nothing on it is decorative. and the card grid below is the same data, un-folded: if scripts are off, the cards still open every essay.

№ 02THE CATALOG

One card per wreckage.

The № tells you where you sit on the shelf; the thesis word says what it is about; the moment says what your hands will do. The checkbox is a reading log — this page remembers which wreckage you've walked, locally, and phones no one. Titles open the essays.

№ 01

Two Out of Three

an interactive essay on the CAP theorem

STATE

Cut a cable, then a second — then choose, under fire, between lying and refusing.

partitionsquorumsAP / CPPACELC
№ 02

The Ring

an interactive essay on consistent hashing

CHANGE

Add a server and watch three of four sessions die; bend the map into a circle and watch them live.

mod-Nconsistent hashingvnodeshot keys
№ 03

The Lock

an interactive essay on two-phase commit & sagas

COORDINATION

Kill the coordinator in the one instant where it matters — then watch the world freeze while a number climbs.

2PCin-doubtsagasoutbox
№ 04

The Cache

an interactive essay on caching & stampedes

STALENESS

Expire one hot key and melt an origin with five thousand simultaneous misses — then fix it three ways.

cache-asideTTLstampedesingle-flight
№ 05

The Ack

an interactive essay on delivery semantics

DOUBT

Lose a receipt and watch one $120 click become two charges — then build the book that forbids it.

at-most-onceat-least-onceidempotency keysreceipt book
№ 06

The Lag

an interactive essay on consistency models

ORDER

Post a comment, refresh, and watch your own words vanish — then watch time run backward.

read-your-writesmonotonicR + W > Nsession tokens
№ 07

The Clock

an interactive essay on time & order

TIME

Let a fast clock erase a later edit — then build a clock that needs no time at all.

last-write-winsLamportTrueTimecommit-wait
№ 08

The Feed

an interactive essay on fan-out & timelines

FAME

Post as a pop star and watch one click become ten million writes — then design the way out.

fan-outpush / pullhybridzombie followers
№ 09

The Nines

an interactive essay on availability math

ARITHMETIC

Add a component and watch reliability fall; spend an error budget until launches freeze.

series / parallelshared fateerror budgetsSLOs
№ 10

The Skew

an interactive essay on isolation levels & write skew

ISOLATION

Walk two honest transactions into an interleaving that empties a hospital roster.

snapshot isolationwrite skewSSIinvariants
№ 11

The Vote

an interactive essay on leader election

SUCCESSION

Freeze a cluster in an infinite storm; crown a ghost that erases a committed fact.

Rafttermspre-votethe log check
№ 12

The Bucket

an interactive essay on rate limiting

ADMISSION

Fire twice the promise through a window's blind spot — then lend instead of count.

fixed windowtoken bucketsliding window429s
№ 03THE PATH

How to walk it.

House rules: this is a plain static site — one build step, no tracking; every essay is its own page, its figures hand-drawn SVG running vanilla in the browser, and the only outside dependencies are the typefaces. The method that built them works for reading, too: open an essay, break its machine on purpose, close the page, and explain aloud what you did and what it cost. If you can do the last step without reopening, the scar tissue took.