Skip to content

A note that uses every medium

A useful note should choose the smallest representation that makes the idea easy to recover. Prose explains intent; tables compare; equations compress; diagrams expose structure; code removes ambiguity.

MediumBest forAvoid when
ProseContext and causal explanationA precise relationship fits one equation
TableComparing a fixed set of dimensionsSequence or topology matters
DiagramFlow, boundaries, and ownershipDecoration is the only purpose
CodeExact executable behaviorPseudocode communicates more clearly
bounded.c
int clamp_int(int value, int low, int high) {
if (value < low) return low;
if (value > high) return high;
return value;
}

Inline math keeps a relationship close to its sentence: the arithmetic mean is xˉ=1ni=1nxi\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i.

A block gives the model room to breathe:

Var(X)=E[(XE[X])2]\operatorname{Var}(X) = \mathbb{E}\left[(X - \mathbb{E}[X])^2\right]

Click the diagram to open the image inspector. Use the mouse wheel or controls to zoom, then drag to pan.

Static notes flow to Cloudflare Pages while local exercise pages connect to isolated compiler and clangd containers.

The editable source is committed beside the SVG as garden-architecture.drawio; exporting it is deliberately manual.

Image inspectorDrag to pan · wheel to zoom
100%