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:PDF vs Help From:<WilliamFLawrence -at- eaton -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 20 Feb 2008 14:10:51 -0500
Just curious what the assembled multitude thinks:
Out of expediency, I recently connected a PDF version of a manual to an
application as context-sensitive help. My normal approach had been to
repurpose XML into both PDF and help, but in this instance I was using
InDesign and had not made the transition from native InDesign format to
XML. Using PDF files as context-sensitive help is fairly trivial, one
just embeds PDF destinations throughout the file and references these
just as one would an HTML anchor in the link. (OK, the syntax is a
little more complex than that, but that's basically it.)
Well, after fielding this I find that I like this approach better. It's
not simply content repurposed into another format, it's the content
coupled with a thoughtfully constructed layout. Moreover, I can control
the PDF display to just about the same degree as I can control help
windows. Like a good help system, this has full-text search, a
cascading table of contents, and a hyperlinked index. Unlike help, the
customer can easily print whatever part of the manual is desired instead
of merely the content of the visible topic.
Granted, in a perfect world one would actually carefully author the help
and the manuals, and not merely repurpose the content. However, given
time and resource constraints, that's rarely possible. So, have I just
sent shudders of doom through all of the HATT companies?
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-