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: Help in Evaluating HATs From:"Bridge, Ian" <Ian -dot- Bridge -at- capita -dot- co -dot- uk> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 19 Jan 2007 12:26:31 -0000
There's been some useful feedback on this topic. The original query also
mentioned another HAT, Author-IT, has anyone any experience using this?
It's one of the items on my 'to-do-list' from my boss, to evaluate it as
a help tool.
Ian Bridge
Procedural Change Service x1094
-----Original Message-----
From: techwr-l-bounces+ian -dot- bridge=capita -dot- co -dot- uk -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+ian -dot- bridge=capita -dot- co -dot- uk -at- lists -dot- techwr-l -dot- com] On
Behalf Of Jim Morgan
Sent: 17 January 2007 16:53
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Help in Evaluating HATs
I am in the course of the same evaluation, and my test asked a very
simple
question: How close is the Help output to the original Word formatting
after
going through the most basic steps (import document into project;
identify
my custom heading styles for purpose of topic breaks; and click the
"build"
button)? Of particular interest was how the products handled the many
outline-numbered steps in the test document, a 70-page administrator
manual.
Help & Manual was not viable because of its requirement that the
document be
in RTF. Doc-to-Help produced output that looks basically like the Word
file
in Word's "Normal" view, with numbered and bulleted lists reproduced
perfectly. The minor problems seem easy to overcome. RoboHelp's output
was
an unholy mess, even after I messed with it for hours. An Adobe engineer
in
a forum blamed Word's admittedly awful code output, but I note that the
lists produced directly from Word into HTML and viewed in a browser
looked
fine, and again, Doc-to-Help had no problem working from the same source
file.
The D2H interface is not intuitive and the conditional text tool is
clumsy.
But it seems like D2H will require the fewest upfront hours, and I see
no
indication that RoboHelp will ever reproduce our lists correctly (which
have
been correctly formatted using Word list styles and thus cause few
problems
in Word).
And no, I'm not connected to any of the manufacturers!
Regards,
Jim
Jim Morgan
Senior Technical Writer (Consultant)
Casabyte, Inc.
Opinions are mine alone, your mileage may vary, etc.
Create HTML or Microsoft Word content and convert to Help file formats
or
printed documentation. Features include single source authoring, team
authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as ian -dot- bridge -at- capita -dot- co -dot- uk -dot-
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/techwhirl/ for more resources and info.
This email has been scanned for all viruses by the MessageLabs SkyScan
service.
This email and any files transmitted with it are confidential, and may be subject to legal privilege, and are intended solely for the use of the individual or entity to whom they are addressed.
If you have received this email in error or think you may have done so, you may not peruse, use, disseminate, distribute or copy this message. Please notify the sender immediately and delete the original e-mail from your system.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-