Using Punctuation w/GUI Labels

Subject: Using Punctuation w/GUI Labels
From: "Ashaki K. Hamlett" <ashaki -at- altair -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 21 Jun 2005 16:13:25 -0400



Hello all,
Many of our GUI labels contain punctuation. For example, browse... or input
file:

When incorporating punctuation from the GUI labels in the procedures, the
procedures become confusing. For example:

Select the browse..., input file:, and component check boxes.

I have always been an advocate making sure the documentation reflects the
GUI. However, in my opinion, omitting the GUI label punctuation will not
hinder the user from selecting or clicking the correct option.

How do others handle documenting GUI labels that contain punctuation?

Many thanks,
Ashaki


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

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l

Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005

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



Follow-Ups:

Previous by Author: Re: Tech writers with typewriters?
Next by Author: Framemaker Template Training
Previous by Thread: RE: Humor: instructions for how to light a match
Next by Thread: Re: Using Punctuation w/GUI Labels


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


Sponsored Ads