# Callout

Aside within documentation or long-form content. Use it to lift out a caveat, a
shortcut, or a prerequisite the reader would otherwise skim past.

## Rules

- Callout is for editorial content. For application state, such as a failed save or an expiring
  trial, use Alert or Banner. They announce to assistive technology; a callout does not.
- One callout per section. Three in a row means the surrounding prose is not doing its
  job.
- `caution` is for irreversible or costly actions. Do not use it for mild inconvenience.
- Give it a `title` when the tone alone does not say why the reader should stop.
- `brand` is not a feedback tone. Nothing is wrong and nothing needs your attention; it is
  the callout for a pull-quote, a feature highlight, or a moment the page is allowed to feel
  like the product rather than like a warning. Reach for `tip` first if the content is
  actually advice.
- `texture` is a dot or line grid behind the fill, drawn in the border-strength colour so it
  never competes with the tone. It reads best on `brand` or `note`; a chromatic tone
  (`tip`, `important`, `caution`) is already carrying enough on its own.

## Tradeoffs

Boxing content pulls the eye out of the reading flow. That is useful once per section and
counterproductive when the page becomes a stack of boxes.