Re: "Picklist"

Subject: Re: "Picklist"
From: "Pro TechWriter" <pro -dot- techwriter -at- gmail -dot- com>
To: "Michael West" <mbwest -at- bigpond -dot- com>
Date: Sat, 18 Oct 2008 18:37:00 -0500

Nice! Great solution, thanks. I am making changes now, so I think I will
give this a try. Anything that is simpler, I am for. :-)

On Fri, Oct 17, 2008 at 9:14 PM, Michael West <mbwest -at- bigpond -dot- com> wrote:

> > 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.
> They couldn't pay me enough to work under those silly rules. I'd drink
> myself into an early grave, or go to the gallows for aggravated
> editoricide.
> Often the best tactic is to avoid mentioning the whiz-bang gadgets at all.
> Focus the users' attention on the data and the purpose of the action, not
> the container. Who really cares whether it's a picklist or dialog box or
> radio button? Those terms usually have no value to the end-user and serve
> only to obfuscate. It's what the action accomplishes in the real world that
> matters.
> Depending on the circumstances, I'd probably try to write something like
> this:
> Make sure the items you want to include are in the right-hand column, and
> those you want to exclude are in the left-hand column. You can use the
> right
> and left arrow buttons to move items from one column to another. [If space
> permits, I'd include a small graphic with callouts pointing to the arrow
> buttons and identifying which column was which.]
> At no point would I use the term "picklist" except maybe when deciding whom
> to submerge in a vat of vinegar.
> --
> Mike West

"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 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:


Re: "Picklist": From: Michael West
Re: "Picklist": From: Pro TechWriter
RE: "Picklist": From: Michael West

Previous by Author: Re: Honestly -- when an SME completely REWRITES your text ... GEEZ!
Next by Author: Re: Alternative to "Thanks"
Previous by Thread: RE: "Picklist"
Next by Thread: RE: "Picklist"

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

Sponsored Ads