# How to [accomplish specific goal]

> A recipe for a user who already knows what they want – Diataxis
> how-to guide. Goal first, steps second, explanation never.

This guide shows you how to [goal]. It assumes you can already
[baseline knowledge]; if not, start with [tutorial link].

## Before you start

- [prerequisite]
- [prerequisite]

## Steps

1. **[Action]**.

   ```bash
   [command]
   ```

   [One line on what this does or what to check.]

2. **[Action]**.

   [Details, options, edge cases.]

3. **Verify it worked**.

   [Observable check: file exists, output shows, status is X.]

## Options

| Option | When to use |
|--------|-------------|
| [flag / variant] | [condition] |

## If it goes wrong

| Symptom | Fix |
|---------|-----|
| [error] | [remedy] |

## See also

- [related how-to]
- [reference page for the values used above]