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: XML conversion From:eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 21 Jul 2003 15:41:28 -0400
Rowena Hart <rowena_hart -at- yahoo -dot- com> wrote on 07/21/2003 03:28:33 PM:
> and Mike asked:
> Why is it unacceptable? (Just curious.)
> and I reply:
> We had the opportunity to test the validity of our
> conclusion with users. In the past, their interaction
> with our product documentation had been less than
> satisfactory because they had to filter out a lot of
> information that did not relate to their specific
> jobs.
For a great reason why documentation (and particularly on-line
documentation) should be targeted to the current users permissions/rights
look at the Lotus notes documentation. The help is virtually useless
because besides being hopelessly fragmented, you can't tell if particular
instructions apply to your installation of not until you try them.
When either license restrictions or permissions restrictions affect your
use, the help should at least identify the limitations up front. Even
better would be to replace the help files for limited functions with
simple explanations of the limitations and what needs to be done to remove
the limitations.
NEED TO PUBLISH FRAMEMAKER CONTENT ONLINE? "Mustang" is a NEW single
sourcing tool for FrameMaker that lets you easily publish your content
online. No macro language required! http://www.ehelp.com/techwr-l3
Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See www.mercer.edu/mstco or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-
---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
