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.
Subject:Re: Chicken or the Egg From:"M Page" <mpage -at- csl -dot- co -dot- uk> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 20 May 2004 09:32:45 +0100
"John Posada" <JPosada -at- isogon -dot- com> wrote in message news:239063 -at- techwr-l -dot- -dot- -dot- [snip]
>...however, some of my windows have as many as
>20-30 fields and dropdown lists.
>I think it's best that I identify the specific place.
The shortened form does this, as long as (i) The field name also fits the
data, and (ii) the field name stands out due to formatting.
"Select a Destination" works if the field is labelled "Destination", and if
the name is highlighted in the text, e.g. bold or italics.
For really big windows where the controls are grouped, I mention the group:
"In Travel Details, select a Destination"
For multi-field windows with no grouping or visual cues, I either present
the procedure as a labelled screenshot, or have recourse to brackets:
"Select a Destination (bottom left)"
"John Posada" <JPosada -at- isogon -dot- com> wrote in message news:239063 -at- techwr-l -dot- -dot- -dot-
Yeah, I see your point...however, some of my windows have as many as
20-30 fields and dropdown lists. I think it's best that I identify the
specific place.
John Posada
Senior Technical Writer
Isogon Corporation http://www.isogon.com
"Realizing Your Business Goals
Through Software Asset Management"
-----Original Message-----
Subject: Re: Chicken or the Egg
Often, if the gui is properly labelled, then "From the" is redundant:
e.g.
"From the Destination list, select a destination"
SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo
>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more. http://www.doctohelp.com
---
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- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
