Effective HTML

Diagrams

Use HTML diagrams to explain architecture, sequences, state, hierarchy, and flow.

Diagrams make relationships easier to see. HTML diagrams can also animate a sequence, reveal detail, or let someone select a path through a larger system.

Animated relationship evidence

Trace one request without flattening the whole system.

Boundary
The architecture remains visible while one request path is emphasized.
Sequence
Ordering and handoffs are carried by geometry and motion.
Exception
The live artifact lets a reviewer choose a different path.

Common diagram types

  • Use a sequence when order and handoff matter.
  • Use a state model when transitions and conditions matter.
  • Use a hierarchy when ownership or nesting matters.
  • Use a flow when material or information moves through a system.
  • Use an architecture view when boundaries and dependencies matter.
  • Use a timeline when change over time matters.

Do not force every subject into a generic left-to-right process.

Keep it readable

Use a small set of shapes, lines, colors, and labels consistently. Keep dense explanation outside the diagram, and check that labels and paths remain legible at the size people will actually view it.

DecksSee how a browser-native presentation can combine slides, interaction, and motion.

On this page