Heuristic

Use a table only when the rows answer the same question

Tables clarify comparison; they can hide narrative dependencies.

Work through the ideaIllustrative example

Use the table when the question repeats.

Compare two venue options on the same three attributes. Then consider an explanation of why one booking failed.

Blank cream letter sheets and a dark binder clip in a mustard envelopeA draft you can inspect

The same attributes apply to each option.

A compact comparison can make effort, constraint and reversibility inspectable.

Fictional venue estimates
VenueCostAccessCancel by
A240StairsMonday
B290Step-freeFriday
When is prose the clearer choice?

When rows need different logic or cells become long explanations.

This example's venue attributes are hypothetical, not real offers. Wide tables can be inaccessible on small screens.

VedokrokKeep the idea. Try the next move.

Before you use it

Use when
  • A table is added because the content feels complex.

Keep this limit in mind

  • Accessibility and mobile viewing can make wide tables hard to use; choose another structure when needed.

Why it matters

Use a table when items share comparable attributes: option, owner, state, risk or date. If cells become paragraphs or each row needs different logic, switch back to short sections. Name the comparison question above the table.

An example

Three migration options fit a table with effort, risk and reversibility; a root-cause explanation does not.

Check your result

The reader can scan across rows without decoding different meanings in each cell.

An idea to explore.

Try this idea.

Inspect the example, try the idea in your situation, then check your next move.

Keep reading
Save and practise this idea

My learning

Read. Recall. Repeat.

Save this idea and return to it on any device.

Use email
Keep exploring

More from this collection

Write asynchronous messages that can be acted on without a meeting

Give technical terms one local definitionEscalate asynchronously with impact, clock and failed path
Evidence and sources
Supports

CDC guidance recommends lists, chunks and descriptive headings to make information easier to scan and organize.

Very short messages may not need headings; structure should match complexity.

Description and Examples of Index Items · Core items 8 through 10

All sources (1)
Edition and review

Version 0.1.0

No review details are supplied for this edition.

Read this idea as JSON · Release details