Re: Help help

Subject: Re: Help help
From: John Garison <john -at- garisons -dot- com>
To: David Loveless <daveloveless -at- gmail -dot- com>
Date: Tue, 04 Apr 2006 14:48:44 -0400


If it were me, I'd start over from scratch - it's hard enough doing
something new for the first time without having to deal with someone
else's old 'stuff'.

As for how to get up and running with Help for the first time ... if you
can find some of the older WinHelp books, they tend to provide a lot of
conceptual information about writing procedural topics, conceptual
topics, and the like, and strategies for linking them all together
seamlessly. Just ignore all the WinHelp 95 references ...

But of there's one key idea that you need to get your head around, I
suggest it's this: Links are free. If you create a whole bunch of topics
that, when taken together, provide all the information necessary to
describe the application, you are then free to create a series of other
pages that provide links to these topics. As a result, you can provide
role-based, experience-based, chronological, or hierarchical
organizations that all consist of links to the individual topic pages.
Within the topic pages themselves, you should link to related topics to
make it easy for users to read and jump around in whatever fashion
appeals to them.

My 2¢,

John Garison

David Loveless wrote <snipped>:

So, does anyone know of a good source for Help help? I'm looking for
basic tips and suggestions...

We have some old help files ... I'm in favor of junking everything and
starting from scratch. Any suggestions there would also be greatly


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!.
Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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 lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.

Help help: From: David Loveless

Previous by Author: Re: I've landed
Next by Author: Re: It's PIZZA FRIDAY!!
Previous by Thread: Re: Help help
Next by Thread: RE: Help help

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

Sponsored Ads