Callouts and Tips

Use concise callouts to improve scanability for long pages.

Recommended pattern

• Start with a short label: Note, Tip, Warning, or Heads up.
• Keep callout body to one or two sentences.
• Link to a full guide if the note needs deeper detail.

Example callouts

Tip: Put setup commands near the top of a page so users can validate quickly.

Warning: If a page references secrets, remind readers to use environment variables.

Note: Prefer stable URLs in docs so search indexes remain healthy over time.