: Re: Technical Documentation Voice Preference : "Active Voice" - "Passive Voice" - A Mixture of both We are working on a technical documentation project which includes the rewriting, modernization, restructuring,
Active voice is the appropriate choice for all types and sections of technical documentation, and for training and service manuals.
The Microsoft Manual of Style is used by professional technical writers.
The 4th edition (2012) says:
In general, use active voice. Active voice emphasizes the person or thing performing the action. It's more direct than passive voice, which can be confusing or sound formal.
Use passive voice sparingly. It is all right to use passive voice in the following situations:
To avoid a wordy or awkward construction.
When the action, not the doer, is the focus of the sentence.
When the subject is unknown.
In error messages, to avoid giving the impression that the user is to blame.
More posts by @Angie602
: Technical Documentation Voice Preference : "Active Voice" - "Passive Voice" - A Mixture of both We are working on a technical documentation project which includes the rewriting, modernization, restructuring,
: Am I correctly punctuating this pause? I want to convey the pause between the "then" and the rest of the sentence. But I'm not sure a comma is the correct punctuation to use. Then, when
Terms of Use Privacy policy Contact About Cancellation policy © selfpublishingguru.com2024 All Rights reserved.