TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Passive voice is not necessarily a problem. It depends on what you want to emphasize. If the subject is unimportant, insisting on emphasizing it can lead to difficult reading and ambiguity.
Two options control how you save the test results: (1) a C drive or (2) a networked, file-management system
is an ugly, wordy, and awkward sentence, and "you" is irrelevant.
Two options control how the test results are saved: (1) a C drive or (2) a networked, file-management system
is a little less wordy, but still clumsy.
You should save the test results on a C drive or a networked, file-management system
Save the test results on a C drive or the networked, file-management system
is even better (if appropriate for the purpose and situation).
BUT suppose you have a situation where you want to emphasize the DO.
Only the test results may be saved on the C drive.
(1) You may save the test results on the C drive only (2) You may only save the test results on the C drive (3) You may save only the test results on the C drive
buries the point of the sentence and creates ambiguity in every case. Does it mean I must save the test results on the C drive and do nothing else? Does it mean I must save only the test results on the C drive and everything else wherever I wish? I can see no way of fixing the sentence without doubling its length to explain the correct process. Also, "you" might be inappropriate. The sentence might about the subject and not to the subject.
The IT professional may only save the test results on the C drive is really ugly and just as ambiguous.
Clearly, passive is the better option, or should I say "Clearly, the IT professional's only option is the use of the passive voice." ;^]
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-