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: "Select" in lieu of other verbs From:"Combs, Richard" <richard -dot- combs -at- Polycom -dot- com> To:"Boudreaux, Madelyn \(GE Healthcare, consultant\)" <MadelynBoudreaux -at- ge -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 25 Feb 2009 10:49:29 -0700
Boudreaux, Madelyn wrote:
<snip> I have one engineer who will only use "select" in all cases where
a
> behavior can be invoked in one or more ways. So, where I've edited a
> line to read, "Touch OK," she changes it back to "Select OK."
>
> She's not just doing it to be ornery. Her reasoning is that the user
can
> invoke "OK," in multiple ways, so she doesn't want to dictate how they
> do it. I maintain that we tell them one way to do it, and not
encourage
> them to do it multiple ways. I suggested we talk to the Human Factors
> manager (her boss), but she wasn't interested in his opinion. I told
her
> I needed to consult the style guides and think about this, and she
> cheerfully told me I could think about it all I wanted; she was
keeping
> "select" as a generic verb. </snip>
Personally, I think the substantive issue isn't worth fighting over. I
don't think "Select," used consistently, will confuse/mislead people or
cause other problems.
BUT ... (and it's a big but) ... there's a bigger problem here than the
choice of verb. Who's in charge? Who owns the doc? Who has the final
word? You said this engineer isn't interested in her boss's opinion --
really??
Has her boss delegated to her the ultimate authority over what goes in
these docs? If so, then you're playing a purely advisory role and you
might as well get used to it. If not, then her lack of interest is
irrelevant -- talk to her boss and clarify just who decides issues like
this: you, the engineer, her boss, your boss, someone else ...
Richard
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------
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. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-