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

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s