Re: active vs. passive
Don't use passive voice is a good rule, but when using it makes the sentence more succinct without sacrificing clarity, use it.^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
I wouldn't write "the directory will be created." But even worse is "the system will create the directory." "System" as subject adds no meaning. If I'm not mistaken the original was trying not to use future tense, another rule of thumb. In this case, it's one I would follow: "If the specified output directory does not exist, it is created automatically."
I'm not sure why, but in software documentation, this sort of future tense is everywhere, and it can be confusing. "Will be" when? "Is" = immediately. Maybe "is" has more smack than "will be" too; I don't know. But here it adds clarity.
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
References:
Re: active vs. passive: From: Bernd Hutschenreuther
Re: active vs. passive: From: Robert Lauriston
Re: active vs. passive: From: Peter Neilson
Re: active vs. passive: From: Robert Lauriston
Re: active vs. passive: From: Lauren
Re: active vs. passive: From: Karin Matchett
RE: active vs. passive: From: Slager Timothy J
Previous by Author:
Re: active vs. passive
Next by Author:
Re: active vs. passive
Previous by Thread:
RE: active vs. passive
Next by Thread:
Re: active vs. passive
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads