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.
One vote for "Appears" sans the "will". I agree that "will appears"
seems unclear on the timing and I'm always a fan of fewer words.
On a slight tangent, I would *love* to hear an argument for displays
over appears that doesn't involve knocking appears for being
"magical". I've never heard a user of my documentation make that
claim, only another Tech Writer. It would be interesting to track down
where the "magical appears" claim first surfaced.
On 5/3/07, Keith Hansen <KRH -at- weiland-wfg -dot- com> wrote:
> 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"!
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-