Explain one task with observable actions and checks a beginner can follow. This worked guide uses a small reproducible example so you can check the result before adapting it to your own task.
Before you start
- A small task you can demonstrate
- A way to record notes or screenshots
Step-by-step guide
Define the starting point
State who the tutorial is for, what they need and what result it will produce. Keep the task small enough to complete in one coherent sequence.
Perform the task while taking notes
Write each action as you do it. Record the input, the action and the result so the instructions reflect a real attempt.
Use one main action per step
Start step titles with a verb and name the relevant tool or item. Explain unfamiliar terms when they first appear.
Add useful illustrations and checks
Place an image beside the action it explains. Describe what the reader should see before moving to the next step and include a recovery hint for a common mistake.
Test from a fresh start
Follow the tutorial using only the written instructions, or ask a reader to identify missing information. Revise gaps and remove screenshots containing private details.
Tips & troubleshooting
- Describe the exact tested version when a tutorial depends on software menus.
- Images should explain an action rather than merely decorate the page.
Common questions
How should I adapt this guide to my situation?
Begin with the small example, use the instructions for your actual materials or equipment, and change one thing at a time so the result can be checked.
What should I check before finishing?
Follow the tutorial using only the written instructions, or ask a reader to identify missing information. Revise gaps and remove screenshots containing private details.
