Manuals / Writing Better Documentation / Ch 2

CraftBeginner35 min read

2. Example first

Writing Better Documentation · 12 pages source format

Show the happy path command or snippet before the theory.

What you'll learn

  • Examples
  • Failure modes

Copy-pasteable wins

If someone can’t paste and succeed, the doc failed. Include expected output.

How-to skeleton
## Goal
## Prerequisites
## Steps
## Expected result
## If it fails

Do this now

Rewrite one paragraph as numbered steps + expected result.

Clear?

Checklist