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.
FYI...
Send your WinHelp listserv (WINHLP-L) subscriptions to:
listserv -at- admin -dot- humberc -dot- on -dot- ca
The company that hosts both listservs has a web site: http://www.documentation.com/home.htm
This page contains links to general information pages for each listserv.
(I like the TECHWR-L info better for its FAQ's, but the WINHLP-L page
lists all the valid commands for modifying your subscription.)
Regards,
Kathy Wyrwas
kathleen -dot- wyrwas -at- unisys -dot- com
>----------
>From: Paul J. Sisler[SMTP:psisler -at- WAVETECH -dot- NET]
>Sent: Thursday, June 12, 1997 11:17 PM
>Subject: Re: RoboHELP question
>
>Tom H writes this stuff . . .
>>
>> First, in regards to general organization and files, I have set up nine
>help project
>> documents, one top-level and eight for the main program areas. Is this a
>good plan in
>> comparison to some advice I've read and heard that a person establish
>files for
>> context-sensitive help topics, glossary topics, how-to topics, and
>overview topics?
>>
>
>If it helps you organize your topics and maintain them, it's good. Nine
>files would be nightmarish for me, but I don't like to categorize my
>topics--there's got to be an Aristotle joke in there.
>
>
>> I am confused by
>> the use of IDH identifiers for context-sensitive topics. Do IDHs need to
>be attached to
>> every context-sensitive topic ID? Is knowing the map number sufficient for
>> this?
>>
>
>I think--but I would have to look it up and I am currently using a <GASP!>
>Macintosh--that IDH is a commonly used prefix when you're linking to a C
>application. What language are your developers writing in? (Please don't
>harrass me for putting a preposition at the end of a sentence.) Otherwise,
>the prefix will just help you remember that those topics are supposed to be
>context sensitive. If you've got a C++ app, more than likely, your
>developers are going to give you a list of map IDs, so ignore your .hh and
>start thinking about the alias section of your .hpj. If it's VB or Power
>Builder or something, you will want to give them your .hh, making it very
>clear which topic ID and map number goes with which control.
>
>Write to me offlist tomorrow if you need to, Tom.
>
>> Our developers think that the great majority of topics will be
>context-sensitive. I know
>> that moving topics from file to file can create a great deal of work.
>
>Not really--if your topics keep the same ID, all your jumps will still work,
>just make sure all your footnotes go where all your topics go. Renaming
>files can create some hpj editing and such but I don't see why you can't cut
>and paste topics with impunity.
>
>
>Try the wihelp list if you need more guidance--don't have subscription info
>on hand, but it's winhlp-l -at- humberc -dot- on -dot- ca, and there is an archive with info
>on some http: server at in Ontario. ;-)
>
>buena suerte
>
>Paul
>
>paul -at- sisler -dot- com
>
>
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html