RE: When to use the word "button" -- ?

["Porrello, Leonard" <lporrello -at- illumina -dot- com>]

Perhaps you can ponder what I might have meant by my last sentence: "And this concludes today's exercise in reductio ad absurdum." Please get back to me if you still don't understand what I was driving at.

-----Original Message-----
From: Lynne Wright [mailto:Lynne -dot- Wright -at- tiburoninc -dot- com] 
Sent: Wednesday, October 24, 2012 9:20 AM
To: Porrello, Leonard; Craig Cardimon; techwrl
Subject: RE: When to use the word "button" -- ?

??!!??? really?

That's way too verbose to describe a simple, standard action. And if the user is that much of a novice they probably won't know what "hover" implies; plus it doesn't cover the fact that most mice have a left and a right button as well as a scroll wheel.

Even though I would hope that a user would know how to click a mouse before they sit down to learn an application, our manuals have a Conventions section up front where we define what Click, right-click, and drag and drop mean. And if they still can't figure out those actions, they're just going to have to ask somebody to show them. No way I'd write to that level of detail in every step of every procedure. 

Actually, given that we only deliver electronic versions of our manuals now, maybe I should take that Conventions section out... because they won't be able to access the pdf or online help files unless they already know basics like how to click!

-----Original Message-----
From: techwr-l-bounces+lynne -dot- wright=tiburoninc -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lynne -dot- wright=tiburoninc -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Porrello, Leonard
Sent: Wednesday, October 24, 2012 11:57 AM
To: Craig Cardimon; techwrl
Subject: RE: When to use the word "button" -- ?

I prefer "Click Continue to proceed." (With "Continue" bolded.) But again, it depends on audience. If your audience is still trying to use the DVD tray as a cup holder, then more explicit may be better. On the other hand, chances are that if your audience can't infer that Continue is a button, they'll be equally at a loss to understand "click". So really, if you are going to use the more explicit form, you should say something like, "1. Use your mouse to move the arrow cursor on the screen so that it is hovering over the Continue button. 2. With the cursor hovering over the Continue button, click the mouse to select the Continue button." And this concludes today's exercise in reductio ad absurdum.

-----Original Message-----
From: techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Craig Cardimon
Sent: Wednesday, October 24, 2012 8:13 AM
To: techwrl
Subject: When to use the word "button" -- ?

I am staring at Apply, Continue, Cancel, and Save buttons, wondering if I should say:

"Click the Continue button to proceed."

Or just:

"Click Continue to proceed."

Opinions?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Writer Tip: You have more time to author content with Doc-To-Help, because your project can be up and running in 3 steps.

See the “Getting Started with Doc-To-Help” blog post. http://bit.ly/doc-to-help-3-steps
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives