Re: Appropriate -- so inappropriate!

Subject: Re: Appropriate -- so inappropriate!
From: Kathleen MacDowell <kathleen -at- writefortheuser -dot- com>
To: "Combs, Richard" <richard -dot- combs -at- polycom -dot- com>
Date: Fri, 10 Jul 2009 15:33:47 -0500

Perhaps you could clarify the sentence beginning, "aggressively
non-technical ..."?

In my experience, vagueness is more likely to originate with engineers or
software developers who are busy doing their primary job, which is not
typically writing instructions or user assistance.

As a non-technical technical writer who does an excellent job documenting
software and hardware, I also take exception to the whole tenor of your
comment. A so-called technical writer who would insert an ambiguous phrase
is simply not in tune with the requirements of the job. It doesn't matter if
they're "technical" or "non-technical".

>
> One of my pet peeves is procedures that verbosely describe exactly how to
> complete a form or dialog -- including information about exactly how many
> characters and what kind each text field can contain, etc. -- and then when
> you get to the critical part, say something like "enter the appropriate
> parameters" or "choose the appropriate options."
>
> BTW, that kind of nonsense frequently comes from aggressively non-technical
> technical writers who insist that their ignorance of the subject matter is
> some kind of advantage.
>
> Richard
>
>
> Richard G. Combs
> Senior Technical Writer
> Polycom, Inc.
> richardDOTcombs AT polycomDOTcom
> 303-223-5111
> ------
> rgcombs AT gmailDOTcom
> 303-777-0436
> ------
>
>
>

--
Kathleen MacDowell
www.writefortheuser.com
kathleen -at- writefortheuser -dot- com
kathleen -dot- eamd -at- gmail -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.
http://www.doctohelp.com/SuperPages/Webcasts/

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-

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/archive%40web.techwr-l.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


Follow-Ups:

References:
Appropriate -- so inappropriate!: From: Nancy Allison
RE: Appropriate -- so inappropriate!: From: Combs, Richard

Previous by Author: Re: Aging out was RE: job-hunt weirdness
Next by Author: Re: Appropriate -- so inappropriate!
Previous by Thread: Re: Appropriate -- so inappropriate!
Next by Thread: Re: Appropriate -- so inappropriate!


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

Sponsored Ads


Sponsored Ads