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.
Unfortunately, our style guide requires "picklist" for a dialog box that has
items in a column that you "move" to another column in the dialog by
clicking a button. Of course, we also have to use "check" and "uncheck" for
checkboxes. And, we can never, never, never, end a sentence with a
preposition! Argh. The convoluted sentences I must write to avoid that one.
PT
On Thu, Oct 16, 2008 at 3:40 AM, Michael West <mbwest -at- bigpond -dot- com> wrote:
> > Have just come across this word for the first time. I find it . . .
> > unpleasant.
> >
> > Do you use this term? Surely "listbox" or just plain "list" are the
> > usual terms. Or has this word been around and I've just missed it?
>
> Oh, it's been around -- I think of it as programmerspeak. In writing for
> users there's no need for it -- or for "listbox". A list is a list. Why
> require people to get used to a new set of terms for things that have
> nothing to do with their real work? It's better to use the terms they
> already know. Everybody knows what a list is.
>
> I might write either of the following:
>
> a) Click the down arrow next to the Name box and then choose a name from
> the
> list.
>
> b) In the Name box, choose a name from the drop-down list.
>
> I would use the first if writing for users who might be unsure of how to
> find the list. I'd use the second if I could be fairly sure that the users
> would know how to find the list; for example, if this was an instruction
> for
> a form that included numerous drop-downs. It's reasonable to assume that
> after you've told them once or twice how to display the list, you needn't
> keep on doing it with monotonous regularity.
>
> --
> Mike West
>
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help gives you everything you need to author and
> publish quality Help, Web, and print content. Perfect for technical
> authors, developers, and policy writers. Download a FREE trial.
>http://www.componentone.com/DocToHelp/
>
> True single source, conditional content, PDF export, modular help.
> Help & Manual is the most powerful authoring tool for technical
> documentation. Boost your productivity! http://www.helpandmanual.com
>
> ---
> You are currently subscribed to TECHWR-L as pro -dot- techwriter -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/pro.techwriter%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
"You can only become truly accomplished at something you love....Pursue the
things you love doing, and then do them so well that people can't take their
eyes off you."
- Dr. Maya Angelou
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-