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

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