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.
Anthony Markatos [mailto:tonymar -at- hotmail -dot- com]:
> Chuck Martin said:
>
> .....I have seen well-managed projects that turned out crappy docs because
> the writing was so horrible, from dense, user-unfriendly
reference-oriented
> information to bad grammar that obscured the meaning and the message.
>
> Tony Markatos replys:
>
> Wow! I have never seen such happen - fifteen years experience. Nor have
I
> heard of such - and I know a lot of tech communicators. Its a mystery!
Well, I feel the need to chip in now. I've seen it. I've seen it quite a
bit, as a matter of fact. I see writing that is convoluted, awkward,
ambiguous, inaccessible and painful to read. I suspect that the reason it
rarely comes up is that your Average Joe probably doesn't really trust his
judgement about writing style, and may just believe that the product is
incredibly complex or he's incredibly dense.
When I was a kid, I used to save comic strips I didn't really get. I assumed
that they were probably very funny and sophisticated, and I just couldn't
wait to get old and wise enough to understand them. I amassed quite an
impressive collection of stupid comic strips by the time that I realized
that the reason I didn't get them was that they were inane and unfunny. I
suspect that the same thing is happening all around us with technical
documentation that's so dense, arcane, and twisted that it's virtually
impossible to figure out what the writer's talking about.
You may be in an industry where this is not so common, but I see it all the
time.