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: Need wording help, please From:Richard Yanowitz <ryanowit -at- NYCT -dot- NET> Date:Tue, 5 May 1998 14:54:41 -0400
At 11:32 AM 5/5/98 -0700, Parks, Beverly wrote:
>The search options are visible only when the number of items in the
>table exceeds the visible area of the table (and thus a scroll bar would
>appear, also).
This is your summary to us, not to your manual readers. Why the
difference? Tighten the language, sure. But if you think this
communicates effectively to the list, why should something else be better
for your manual audience?
In particular, the parenthesis is a big help (maybe better as something
like: "so that the scroll bar appears"). The preceding part I don't
understand in any form, but perhaps it would make sense if I were looking
at the illustration.
Is it the case that when the scroll bar doesn't appear, the software
designers want users to eyeball the screen instead of searching? This
doesn't seem too helpful unless there are minimal data (3? 6?) that fit
into a single display. If so, you might try something like: "If [x
software] can't fit all data on the display, you will see (a) a horizontal
scrollbar and (b) three buttons to help you find a specific item." Edit
that for accuracy and spiff up the formatting.
Good luck.
Richard Yanowitz, NYC
ryanowitz -at- bigfoot -dot- com
Freelance writers (including tech writers): join the National Writers Union
Web site: http://www.nwu.org/nwu/
E-mail: nwu -at- nwu -dot- org