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:The importance of good tech writers From:"Jessica N. Lange" <jlange -at- oee -dot- com> To:"TechWR-L" <TECHWR-L -at- lists -dot- raycomm -dot- com> Date:Fri, 7 Jul 2000 07:41:10 -0400
So I'm reading thru' another list this morning, and a message
about really bad Online help made me think of many
discussions on *this* list.
"ColdFusion Studio will automatically convert MS Word
documents to HTML... I was lucky enough to stumble
across documentation on it yesterday....
"To stumble across it you have to read the helpfile
on "Visual Editing In Design Mode" which is probably
not where you are going to look if you are trying to
figure out how to convert Word documents."
I'm quite sure that no-one on THIS list was responsible for
authoring that help file. I'll go further--I doubt if the author
of that help file was trained as a TW. It seems to me that
at the *very least* there should have been a heading in the
TOC or index entries explicitly saying "Converting Word to
HTML"! Gosh, isn't Word to HTML conversion one of the
*most* desired features of any software?!
This is the kind of online help file that makes people hate
computers and *never* use the online help!