Re: Technical Writing Books

Subject: Re: Technical Writing Books
From: Alexia Prendergast <alexiap -at- SEAGATESOFTWARE -dot- COM>
Date: Thu, 15 May 1997 13:24:31 -0400

In my opinion:

If you *have* to use "click", use "click", not "click on".

*However*...

"Click" is a pet peeve of mine. You do not "click" a
button. You click a *mouse* button to *select* a GUI
button. Since there are many ways of selecting an object
(mouse, accel key, etc.), I always write "Select the blahblah
button" instead of "Click" -- that way, I let the user
decide how they want to select it. (If the users are such
novices that they might not know what selection options
they have, I include a module describing them.)

On a related note, I use "Choose" for menu items.

Thank you for letting me rant...

Phew. That was cathartic. :)

Alexia

--
Alexia Prendergast
Senior Technical Writer
Seagate Software
alexiap -at- sems -dot- com

>----------
>From: Floramaria Deter[SMTP:fmc -at- NETCOM -dot- COM]
>Sent: Thursday, May 15, 1997 1:08 PM
>To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
>Subject: Technical Writing Books
>
>For example, I have been told to write "click on the button" but according to
>the Manual of Style book, the correct way is to write "click the button."
>

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: our recent discussion of proofing, required technical skills, and writing in general
Next by Author: Re: Technical Writing Books
Previous by Thread: Technical Writing Books
Next by Thread: Re: Technical Writing Books


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


Sponsored Ads