Legend
How to read the diagrams
Every lesson uses the same visual language. A colour or shape means one thing everywhere: in diagrams, in the prose, and in the map on the home page.
Try the controls
- ◀▶ or ←→ step back and forward
- Space play and pause
- ↻ replay from the start
- the dots jump to any step
- diagrams play once on their own when you scroll to them
What things are
The shape tells you what kind of thing it is.
- Client / userswhoever is asking
- Servera machine running the service
- Disk / storagewhere data lives
- Componentload balancer, gateway, tool…
- External dependencya service you call
- Operatora human making changes
How healthy it is
Every state has a shape cue as well as a colour, so it reads in greyscale too.
- Healthygreen light, solid outline
- Slowamber, dashed ring
- Faultred, pulsing ring
- Downgrey, dashed, ✕
What travels
Messages move along links. Their speed is slowed right down so you can follow them.
- Requestfilled dot on its way
- Replyhollow dot coming back
- Droppedlost on the way: ✕
- Bad changea poisoned config or kill signal
Links and groups
- Linktwo things talk
- Cut linktraffic stopped
- Active linkthe path that matters now
- Groupa zone, data centre or side
- Partitionthe network is split here
- Out of focusdimmed so the step stands out
Roles in replicated systems
When nodes play roles, the colour is the role. It means the same thing in every lesson.
- Leaderaccepts writes
- Followercopies the leader
- Candidaterunning for leader
- Committeddurable, agreed
Words in colour
When a word in the text has a coloured dot, it matches the thing in the diagram, so you never need to hunt for a key. For example: the leader, a follower, a client, a failure.
The map
The home page and the Map page draw everything in your notes as a 3D map. Drag to orbit it.
- Bright star: a concept you've learned. Mark a lesson learned (the toggle on its page) and its stars light up.
- Soft star: a concept whose lesson you haven't marked learned yet.
- Coloured cluster: a topic area, such as storage, replication or transactions.
- Glowing thread: a stream of stars linking neighbouring topic areas.
- Moving light: knowledge flowing from a prerequisite to what builds on it.
- Lines between stars: at rest, only prerequisites and contrasts. Hover or select a star to see all of its connections.
Links between notes
In the knowledge graph, each kind of relationship has its own line.
- requireslearn that first
- upbelongs under a broader topic
- contrastsan alternative approach to the same problem
- relatedworth knowing together
- examplesa real system that uses it