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: Educating Rita From:Dawn-Marie Oliver <Dawn-Marie -at- CONCUR -dot- COM> Date:Mon, 3 May 1999 11:13:35 -0700
> I've see plenty writers stick their nose issues where they
weren't invited only
> to then wonder why the engineers don't respect them. How would
you like it if
> an engineer told you how to format a document, what fonts to
use, or the
> "correct way" to write. You'd be pissed.
I've not only had them do this very thing (grammar corrections,
I've had them become LIVID when I didn't make the corrections they
I don't get pissed when an engineer comments on these things. I may
frustrated if it's excessive, but I always at least listen. To me,
of building mutual respect.
If an engineer doesn't take a suggestion of mine, 9 times out of
10, I say "Oh well". That 10th time, not taking the suggestion
often takes up
such a great amount of time documenting that I can convince the team
the UI change is more effective.
> Furthermore, this issue beckons the misguided notion that tech
> "advocates" for the user. I do not feel technical communication
> to do with being a "advocate" for the user. This is something a
lot of tech
> writers use to distract themselves from their primary task -
But if the documentation is not usable by the audience it is
what is the point? To continue your pizza example, "producing
might result in a pizza that had uncooked dough, frozen sauce,
and unsliced pepperoni. It's all there (good information), it's up
consumer to find their own way. (But I ordered a fully-assembled
pizza to be delivered HOT to my door; why do I have to do what I've