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: Modern vs Old-fashioned Help From:<Brian -dot- Henderson -at- mitchell1 -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Mon, 25 Jul 2011 11:35:05 -0700
None of my work involves creating any of the sort of Help systems talked
about on this list. Mostly, I work with a proprietary browser-based
product created from a vast SGML database. Certain forms of tagging
within the SGML "articles" are used to create the navigation links in
the final product. The navigation pane is akin to PDF bookmarks, but a
lot more flexible.
Most of the files in the database only require straightforward and
simple tagging. But a lot of the sub-sets of articles I work with need a
bit more convoluted sort of organization. They're niche products going
to customers with their own particular requirements.
And some of my projects have been actual PDF e-books that also needed
rather tricky bookmark organization. Not that the bookmarking is
particularly advanced, but I don't often see PDFs that use the full
bookmarking abilities.
-BH
-----Original Message----- From: Kevin McLauchlan
Is there some major thing that you do, that predecessors omitted?
Or is it just a long, tedious slog of inserting millions of cross
references and index markers, and creating sub-ToCs everywhere?
--------------------------
- k
> -----Original Message-----
> From: Brian -dot- Henderson -at- mitchell1 -dot- com
>
> I've had so many bad experiences with horrible navigation in
> electronic documents that creating good navigation is now one of my
> absolute top priorities.
> I've taken over many existing projects that have required a complete
> makeover, and most of the time the only feedback I get is about how
> much easier the re-vamped product is to use. With all the changes that
> I might have made, it's the improved navigation that gets noticed the
> most.
>
> -Brian H.
The information contained in this electronic mail transmission may be
privileged and confidential, and therefore, protected from disclosure.
If you have received this communication in error, please notify us
immediately by replying to this message and deleting it from your
computer without copying or disclosing it.
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-