passive voice
Posted Jun 24, 2011 18:31 UTC (Fri) by
giraffedata (subscriber, #1954)
Parent article:
The platform device API
Once both a platform device and an associated driver have been registered, the driver's probe() function will be called and the device will be instantiated. Registration of device and driver are usually done in different places and can happen in either order. A call to platform_device_unregister() can be used to remove a platform device.
Here's an excellent example of the evils of passive voice (and its cousin, nominalization - using a noun instead of a verb for an action). It is not immediately clear who is doing all these things (registering, calling, instantiating, using). Were the paragraph in active voice, that information would be unmissable.
Plus there's the fact that the human brain is set up to comprehend things by forming an image of A acting on B, rather than of some abstract action by abstract agents taking place in the ether. So a reader would have to do considerably less processing to comprehend this paragraph in active voice.
(
Log in to post comments)