- We design and build extraordinary applications for companies looking to make the next great idea a reality.
- learn more
Writing Technical Requirements: The Fifth Commandment
The Fifth Commandment:
Maintain Active Voice and Keep It Wholly
sentence:
The boy threw the ball.
Passive Voice
sentence:
The ball was thrown by the boy.
1. Active
Voice sentence is shorter and more to the point.
2. The
reader doesn't find out who actually performed the action until the end of the
sentence.
3. The
writer could have eliminated the last three words of the Passive Voice Sentence
and still had a complete sentence.
4. The
Passive Voice sentence includes a helper verb for thrown, Passive Voice always
uses a form of the verb 'to be.'
5. The
Passive Voice sentence changes the Subject (the person place or thing that
performs the action) to the Direct Object (the person place or thing that is
acted upon).
6. The
Passive Sentence can include a new thingie grammarians call an
"agent," which is the actual subject of the sentence (boy).
The grammar lesson pretty much sucked, didn't it? Look at it
from your reader's point of view.
If we use the old A.T. & T. Communication model (http://www.cultsock.ndirect.co.uk/MUHome/cshtml/introductory/sw.html), we don't get the complete picture. Besides what we're doing on the sending end (organizing and encoding) the receiver has to decode the message which involves the reader's intelligence, experience, interest and motivation: and you have no control of any of those variables. That's why the KISS (Keep It Simple Stupid) method works. And active voice is less complicated for your reader- making it easier to decode and understand.
That's why you
don't use Passive Voice unless you have to convolute the sentence to avoid it.
Next up: The Sixth Commandment: Santa isn't the only Clause.
Powered by ScribeFire.
Leave a comment
About Pathfinder
Recent
- Thanksgiving 2008: What We’re Thankful For (In Rails)
- iPhone SDK: Testing with TextMate & GTM
- GWTQuery - JQuery-like Syntax in GWT
- Ask the readers: How do I fire native browser events in Prototype.js?
- News Rollup for the Week of November 17, 2008
- Rails ThreatDown!
- Automated Deployments Rock
- Bandwidth profiling Flex projects and more with Charles
- iPhone SDK: UIViewController Testing & TDD
- Icons are evil; so are menus - unless you do them right
Archives
- November 2008
- October 2008
- September 2008
- August 2008
- July 2008
- June 2008
- May 2008
- April 2008
- March 2008
- February 2008
- January 2008
- December 2007
- November 2007
- October 2007
- September 2007
- August 2007
- July 2007
- June 2007
- May 2007
- April 2007
- March 2007
- February 2007
- January 2007
- December 2006
- November 2006
- October 2006
- September 2006
- August 2006
- July 2006
- June 2006
- May 2006
- April 2006
- March 2006

