Re: The second person in user guides
Some have suggested that to engage the readers, we should write the--
companion guide in a breezy, casual style using the second person ("you
should do this," you should not do that," "your document should
include," blah, blah). Others say this is tantamount to an approval of
such usage in formal documents, and is unnecessary in any event --- the
imperative mood ("do this," "don't do that") works as well or better,
and it does not imply that "you" and "your" should find their way into
documents released to publications or the public.
Beth Agnew
Professor, Technical Communication
Seneca College of Applied Arts & Technology
Toronto, ON 416.491.5050 x3133
http://www.tinyurl.com/83u5u
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author content and configure Help in MS Word or any HTML editor. No proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
Follow-Ups:
- RE: The second person in user guides, David Farbey
References:
The second person in user guides: From: Sagendorph, Wallace
Previous by Author:
Re: Version Revision number
Next by Author:
Re: Version revision number
Previous by Thread:
Re: The second person in user guides
Next by Thread:
RE: The second person in user guides
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads