How to [accomplish specific goal]
How-to guide (Diataxis) – goal-first recipe
Cómo usar: Diataxis how-to. It answers "how do I X" and nothing else – explanation and reference get links, not paragraphs.
Vista previa
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
-
[Action].
[command][One line on what this does or what to check.]
-
[Action].
[Details, options, edge cases.]
-
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]