RE: Modern vs Old-fashioned Help

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.


-----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.

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:

Re: Modern vs Old-fashioned Help: From: Nancy Allison
Re: Modern vs Old-fashioned Help: From: Peter Neilson
RE: Modern vs Old-fashioned Help: From: Brian.Henderson
RE: Modern vs Old-fashioned Help: From: McLauchlan, Kevin

Previous by Author: RE: Modern vs Old-fashioned Help
Next by Author: RE: swapping monitors?
Previous by Thread: RE: Modern vs Old-fashioned Help
Next by Thread: Re: Modern vs Old-fashioned Help

What this post helpful? Share it with friends and colleagues:

Sponsored Ads