Docs Edit Pass
by PixelBadger Creative Production › Editing
50 minutes 6 Steps
-
Prepare
- Open the doc in a different font or on a different screen to see it fresh
- Write down who the doc is for
-
Accuracy pass
20 minutesRun every command and code sample from scratch. Fix anything that breaks.
-
Break
5 minutes -
Clarity pass
15 minutesCut jargon, keep one idea per sentence, and use the imperative for instructions: run, not you can run.
-
Scannability pass
10 minutesHeadings as tasks, numbered lists for steps, and warnings in bold.
-
Final checks
- Every link works
- Screenshots match the current UI
- Spelling and grammar checked