diataxis-how-to
Write, expand, or audit a how-to guide — goal-oriented documentation in the Diátaxis sense: directions that help an already-competent reader accomplish a specific real-world task. Use whenever the user wants a "how to X" doc, a runbook, playbook, recipe, troubleshooting guide, setup/configuration/ migration/deployment/integration instructions, or step-by-step directions for practitioners — even if they never say "how-to guide". Also loaded by the diataxis router when the compass points to action + application: the reader will *do* something to *get work done*. If the reader is a beginner who needs to learn by doing in a safe setting, that's diataxis-tutorial instead; if the content mostly enumerates options and facts, that's diataxis-reference. When the type is in doubt or mixed, consult the diataxis skill first.
Pinned to revision a943fbd893c9, so it is the text this page describes rather than whatever the author pushed since.
Files
Every link opens the file at its source, pinned to the revision this page describes.