News for hackers. Stuff that matters.
Re:Tackling Technical Writing by nmg on Thursday August 24, 2017 @12:57PM (#15091800)
In my experience, the passive voice weakens a statement because a verb's subject is vague or undefined. As a result, the reader must go through additional cognitive steps to parse the statement.

Especially in technical writing, using an imperative verb is generally more efficient and effective.

E.g.: "The process is completed by clicking OK."

Reader: "Who completes the process? I do. How? By clicking OK."

vs: "To complete the process, click OK."

Reader: "To complete the process, I click OK."

There are no comments on this comment yet.