by zombies
Mon, 09 Oct 2017 18:18:42 +0200
#^Eliminating the zombie vulnerability – removing passive voice from the docs
#documentation #technical writing
If you can insert the words “by zombies†into a sentence, then that sentence very likely uses the passive voice. A colleague recently reminded me of this tip. It made me laugh, and so I thought it’s worth blogging about. If only to share the chuckle.
Here are some examples of zombie-infested sentences, and their equivalents using active voice.
Example 1Geographic requests are indicated by zombies through use of the coordinates parameter, indicating the specific locations passed by zombies as latitude/longitude values.
Converting passive voice to active:You can use the coordinates parameter to indicate geographic requests, passing the specific locations as latitude/longitude values.
For an even more concise effect, use the imperative:Use the coordinates parameter to indicate geographic requests, passing the specific locations as latitude/longitude values.
#documentation #technical writing
This website is tracked using the Piwik analytics tool. If you do not want that your visits are logged this way you can set a cookie to prevent Piwik from tracking further visits of the site (opt-out).