← back

Notes → diagram

You don't invent the diagram. It's already hiding in your words — find it. A method for turning a page of notes into the one picture it wants to be, plus the same system drawn four ways.

the whole method

The words in your notes tell you the diagram. A recurring noun wants a box; a “then / sends” wants a sequence; an “if / fails” wants a flowchart. Read the tells, pull the picture out in four passes, then draw coarse to fine.

1 · Which type? The words tell you

Scan your notes for these tells. Each one names a diagram type before you draw a single line.

What you wroteWhat it wants to be
a noun you write twicebox / component
then · sends · returns · aftersequence
if · fails · valid? · else · retryflowchart
parses · translates X→Y · mapsdataflow
owns · responsible for · belongs toresponsibility map
a ?margin note, NOT a diagram

2 · Extract it in 4 passes

  1. Circle the nouns. → boxes
  2. Underline the verb between two nouns. → arrows
  3. Box the questions off to the side. → margin
  4. Pick the ONE relationship you care about — order? data? decision? ownership? That names the type.
the tell — does this sentence want to be a picture?

2 nouns + a verb (“connector parses frames”) = 1 arrow, 2 boxes. Draw it.

1 noun + adjectives (“state is authoritative”) = a label. Don't box it.

See no diagram at all? You don't have components yet — you're still listing. Force the 3–7 nouns first; the boxes appear the moment the names stabilise.

3 · Order to draw them — coarse → fine

Top-down layers → dataflow → sequence → flowchart. The first two describe the whole system; the last two zoom into one corner — reach for them only when a bit is tricky.

One exchange-integration system, drawn four ways. Each view answers a different question — pick the one that fits what you need to say.

1 · Top-down layers
How the layers stack and who owns what. Exchange on top; market data flows down, orders flow back up. The spine of the system — start here.
Top-down layered architecture of an exchange integration
2 · Dataflow (DFD)
What data moves and how it transforms. Processes, stores, and the data labelled on every arrow — no timing, no control.
Dataflow diagram of the same system
3 · Sequence
When things happen. Actors across the top, time down. Use to zoom into one interaction — the place-order round-trip.
Sequence diagram of the place-order round-trip
4 · Flowchart
Decisions and branches. Use for one tricky corner — the order lifecycle with its retry / escalate error paths.
Flowchart of the order lifecycle