Dec
18th
Tue
18th
4-steps for faster chapters
This is a formula for quickly writing an engaging, practical tutorial. It works for programming, admin interfaces, applications or whatever tech topic you want.
It gives you a straightforward process to follow for any technical topic. Avoid writers block and make rapid progress.
Any tutorial has four components:
- Instruction
- Explanation
- Discussion
- Narrative
Each type of content requires different writing skills and focus. Make your life easier: focus on one kind of content at a time, in this order.
- Write the instructions first
- Add an explanation that sits underneath each set of instructions
- Below each explanation, discuss the general concepts and commands that each example demonstrated
- Bring all these separate chunks together so it flows like a story
Don’t get lost in later steps if you’re not happy with the earlier ones.
How should you write each section? I’ll leave that for part 2…