News for hackers. Stuff that matters.
Re:How to Write in Plain English by docent8 on Tuesday August 25, 2020 @10:26AM (#24271653)
This guide makes excellent points. I also recommend this book:

https://www.amazon.com/Style-Clarity-Chicago-Writing-Publish...

He says that to achieve clarity, imagine the subject of each sentence as the character of a scene, and the verb as its action. Make sure you hit both character and action within the first 6-10 words of your sentence.

Begin each sentence with information that the reader is familiar with, and end it with the new information you want to introduce.

That will get you a long way toward creating understanding (and feeling) in the reader.

There are no comments on this comment yet.