Re: active vs. passive
You're turning guidelines into superstitions."Which"? I was taught in legal writing, "beware of the which-es." Your example would not be my choice. I would say, "Use bulleted lists because they are easy for the reader to scan and read." Also, when I first read your sentence, I thought you meant OCR and it is not true that bulleted lists are easier to scan with OCR.
Overuse of the infinitive form of "be" might a hallmark of bad
writing, but sometimes it's the right choice. "Use bulleted lists,
which are easy to scan and more likely to be read."
Same goes for passive voice. "If the specified output directory does
not exist, it will be created automatically" puts the emphasis on the
directory. The point is that the user does not have to create it
manually beforehand. Nobody cares what creates it.
I would not state the command like that. First, "it will be created" refers to something outside of the sentence and the reader is left to assume what that it is. I would specify what is creating the directory. The system, app, program, or whatever it is. I would say, "The system will create the specified directory if it does not exist."
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
Follow-Ups:
- Re: active vs. passive, Robert Lauriston
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: Robert Lauriston
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