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.
RE: Use of the second and third person in documentation
Subject:RE: Use of the second and third person in documentation From:"Hadley, Tim" <tim -dot- hadley -at- ttu -dot- edu> To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Thu, 24 Feb 2005 09:58:00 -0600
IMHO, either is acceptable as long as it is consistently applied.
However, also IMHO, the standard 2nd person imperative verb (click) is
preferable in most cases:
--To submit your information, click Submit.
--To contact us, click Send Us An Email.
Etc.
Tim
Tim Hadley
Graduate Assistant, Graduate School Fellowships and Scholarships
Ph.D. candidate, Technical Communication and Rhetoric
Texas Tech University
-----Original Message-----
From: bounce-techwr-l-114459 -at- lists -dot- techwr-l -dot- com
[mailto:bounce-techwr-l-114459 -at- lists -dot- techwr-l -dot- com] On Behalf Of A.H.
Sent: Thursday, February 24, 2005 9:52 AM
To: TECHWR-L
Subject: Use of the second and third person in documentation
Hello, all,
Is it standard practice to refer to users of
software a "the user" or "users," or as "you"?
Examples: 1. Users can click...
2. You can click...
Thanks,
Anthony Hernandez
Technical Writing Intern
Fund for the City of New York
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.