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.
Save and practise this idea
My learning
Read. Recall. Repeat.
Save this idea and return to it on any device.
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 pathEvidence and sources
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.
