Make your tutorials pop by avoiding dry pedantry

Just because you’re dealing with a scholarly discipline that’s usually reported in a style of dry pedantry is no reason why you shouldn’t write in good fresh English. — William Zinsser —

This is a quote from “On Writing Well” by William Zinsser and something I struggle with when writing tutorials.

I always fall back to the boring style of — do this, then this, next that, and finally this. Tutorials and advanced concepts are more accessible if written like a person and not like a developer.

Tell a story, make it interesting, and draw the reader in.

Leave a Reply