3 ms·
The plain English campaign [1] has some great advice and tips (especially about using bullet points.) For tutorials specifically, use imperative mood for the i
by rjmill 4y ago
The plain English campaign [1] has some great advice and tips (especially about using bullet points.)
For tutorials specifically, use imperative mood for the instructions and headings.
Instead of, "Doing the thing," or, "How to do the thing," just say, "Do the thing."
I've noticed good tutorials using imperative mood, and my tutorials got much better when I started using it too.
In English, imperative mood is the best signal-to-noise you can get. It works well for tutorials because the target reader wants you to tell them what to do.
[1]: http://plainenglish.co.uk/how-to-write-in-plain-english.html http://plainenglish.co.uk/how-to-write-in-plain-english.html