RE: Use of the second and third person in documentation

Subject: RE: Use of the second and third person in documentation
From: "Barb Einarsen" <barb -dot- einarsen -at- navtelcom -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 24 Feb 2005 11:01:25 -0500


It depends ;-D

If I am talking to someone (like an Administrator or a Programmer) and
telling them what someone else (like a User or an Adminstrator) may do,
I would use "the user" or "the customer/client/developer/administrator"
and so forth.

However, if I am talking to the person directly, whether it be the
administrator/user..., I would use "you".

For example:

"If you set the WhatHaveYou, the ThingAMaJig displays for the user."

Or:

"Select the Whatzit you want to configure from the drop-down list."

Barb

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

Doc-To-Help 7.5 Professional: New version with new features, improved performance and reliability, plus much more! Download your free trial today at www.componentone.com/techwrlfeb.

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Previous by Author: RE: Acrobat 7.0
Next by Author: RE: as opposed to the user's user name
Previous by Thread: RE: Use of the second and third person in documentation
Next by Thread: RE: Use of the second and third person in documentation


What this post helpful? Share it with friends and colleagues:


Sponsored Ads