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.
I try to use only the present tense. If needed, I use the simple past. I
avoid the future tense as much as I can, as it is usually unnecessary.
I also try to avoid writing that the goal of the instructions is to open
a dialog box; it's not. The goal is to perform some other task, and
opening the dialog box is part of that larger task. So, click ABC tells
what to do and that the XYZ dialog box opens provides feedback that the
correct task was done.
Make sense?
Cheers.
-----Original Message-----
From: techwr-l-bounces+sean -dot- brierley=ipc -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+sean -dot- brierley=ipc -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Lauren
Sent: Thursday, May 03, 2007 12:26 PM
To: 'Keith Hansen'; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: "Appears" vs. "will appear"
FWIW: I avoid the use of the word "appear" altogether because is sounds
like the new window just manifests out of nothing. Here is a No. 3
option.
"Click the ABC to open the XYZ dialog box."
Lauren
> -----Original Message-----
> From: techwr-l-bounces+lt34=csus -dot- edu -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+lt34=csus -dot- edu -at- lists -dot- techwr-l -dot- com] On Behalf
> Of Keith Hansen
> Sent: Thursday, May 03, 2007 9:11 AM
> To: techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: "Appears" vs. "will appear"
>
> I want to canvass your opinions here. Which do you prefer:
>
> No. 1: "Click the ABC button. The XYZ dialog box appears."
> No. 2: "Click the ABC button. The XYZ dialog box will appear."
>
> I prefer "appears." It's more concise (one word vs. two). Also, "will
> appear" sounds like a future prediction, rather than a statement of
> what occurs. Compare the following:
>
> "The clouds gather. It rains."
> "The clouds gather. It will rain."
>
> Please vote for No. 1 or No. 2. Give reasons for your preference.
>
> Thanks.
>
> Keith
>
> P.S. BTW, I had a colleague who abhorred the use of the word "appears"
> or "will appear." She said it made the process sound magical
> ("Abracadabra! It appears!") So she would write a sentence like this:
>
> "The XYZ dialog box is displayed by the software."
>
> But this is passive voice (if I'm not mistaken; the subject is acted
> upon, rather than acting). So the sentence was then rewritten like
> this:
>
> "The software displays the XYZ dialog box."
>
> However, the subject of our sentence (software) is not really the
> center of our attention here. The center of attention is actually the
> dialog box, which is now shoved to the end of the sentence.
>
> Personally, I can live with "appears"!
DISCLAIMER:
Important Notice *************************************************
This e-mail may contain information that is confidential, privileged or otherwise protected from disclosure. If you are not an intended recipient of this e-mail, do not duplicate or redistribute it by any means. Please delete it and any attachments and notify the sender that you have received it in error. Unintended recipients are prohibited from taking action on the basis of information in this e-mail.E-mail messages may contain computer viruses or other defects, may not be accurately replicated on other systems, or may be intercepted, deleted or interfered with without the knowledge of the sender or the intended recipient. If you are not comfortable with the risks associated with e-mail messages, you may decide not to use e-mail to communicate with IPC. IPC reserves the right, to the extent and under circumstances permitted by applicable law, to retain, monitor and intercept e-mail messages to and from its systems.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. 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- web -dot- techwr-l -dot- com -dot-
