Re: Describing buttons and fields

Subject: Re: Describing buttons and fields
From: Maggie Pierce Secara <maggiros -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 3 Feb 2003 15:38:42 -0800 (PST)


I don't think I ever use quotati0on marks in technical
docs. Nope. I'm sure I don't. I emphasize the names
of things I want you to click or press with bold, same
font, 1pt smaller than regular text. When I say,
"Locate a file called Spandex" I give the title in
italics. When I want to tell them to enter a specific
thing in a field, I never ever use quotes, because you
know good and well that they'll type in the quotes.
So I say:

Type: Spandex

And if I tell them what to put in a bunch of fields in
a dialog, I do it with a table. Not need for quotes.

I also say "Click OK." and not "Click the OK button."

Nope, quotation marks clutter the page and tire the
eye. At least, they tire mine.


Cheers!

Maggie Secara



--- DaveC <peninsula -at- covad -dot- net> wrote:
>
> Is it
> 4. Click the "Browse" button...
> or
> 4. Click the Browse button... ?
>
> Are quotes in this situation reserved only for
> find the file labelled "Bozo and Herman"...?
> How do you use quotes in technical docs?
>

__________________________________________________
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l


---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Follow-Ups:

References:
Describing buttons and fields: From: DaveC

Previous by Author: RE: credit check for interviews
Next by Author: Re: PM/Tech Writer/Security
Previous by Thread: Describing buttons and fields
Next by Thread: Re: Describing buttons and fields


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


Sponsored Ads