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.
> How about a simple save file process as an example of the 4 stances?
> 1st - I click "File," "Save As," and choose a name for the
> file when I want to save the file.
> 2nd - You need to click "File," "Save As," and choose a name
> for the file when you want to save the file.
> 3rd - The user needs to click "File," "Save As," and choose a
> name for the file when he or she wants to save the file.
Fine examples of the three grammatical persons. Not stances.
> Neutral - Click "File," "Save As," and choose a name for the
> file to save the file.
As Andrew noted, this is just another example of the 2nd person. This
time, the verb is in the imperative mood, so the subject is "you" and is
> literally impossible to tell who is doing what to whom! The
> primary reason for this is that the sentence is loaded with
> passive voice. In correcting this mess, without explicitly
> identifying to whom I am referring, it is very difficult to
> write a cohesive sentence about the procedure that I want the
> user to follow. In these cases, I tend to say "The Test
> Operator clicks here, the PC responds with this, the Unit
> Under Test does that..."
Address the reader! In your example, I sincerely doubt that the reader
will ever be the PC or the Unit Under Test, so you refer to them in the
3rd person. Presumably, the Test Operator is your reader, so you refer
to her or him in the 2nd person. But if you're writing instructions for
the Supervisor who oversees the Test Operator, then you refer to the
Test Operator in the 3rd person and address the Supervisor. Especially
for procedural information, you must identify the reader, and then
address the reader.
Richard G. Combs
Senior Technical Writer
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-