3 ms·
Write in active voice. That's the single most important lesson I learnt when writing technical specifications. The #1 goal of technical writing is to be clear
by NamTaf 6y ago
Write in active voice. That's the single most important lesson I learnt when writing technical specifications.
The #1 goal of technical writing is to be clear and accurate, so passive voice should take a back seat unless you cannot phrase it otherwise. Active voice lets you convey clearer, more concise statements that describe a concept.
Take for example "the ball was thrown by the man" vs "the man threw the ball". The latter is much more concise and easier to parse because the active object preceeds the passive one and so the concept unfolds linearly.
If you're using Word for writing, go into options > proofing > find 'writing style' and hit 'settings' > turn on 'passive sentences'. I just throw it to the default 'grammar & style' because I'd prefer to know of and actively decide against style issues than not. It's helped drill my writing significantly.
- valbaca 6y agoThanks for the tip for Word! Those settings are put real deep in the options.