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.
Context-sensitive help with Forehelp and SourceSafe
Subject:Context-sensitive help with Forehelp and SourceSafe From:Debbie Pesach <dpesach -at- SOHOLYNK -dot- COM> Date:Wed, 9 Jun 1999 10:44:30 +0300
Cross posted to Tech-Shoret, TECHWR-L and ForeHelp Technical Support.
(TECHWR-L: I'm on the digest, so please reply or send cc directly to me)
Greetings!
I need some help with the following:
Background
I work in ForeHelp to create context-sensitive online help for an
application written in C++. I've been having a somewhat friendly
"debate" with the SME about how to incorporate the context-sensitivity
so that his dialog IDDs will match the context IDs of Forehelp (for
automatic mapping of the two, including whenever there are changes to
the interface or new topics created). Project is to be saved in
SourceSafe. I have limited experience with ForeHelp.
Problems/Question(s)
I've heard that SourceSafe and ForeHelp don't always play well together:
Bitmaps in ForeHelp projects can be blown. I have very limited
experience with using the context tools of ForeHelp. When I tried to use
the QuickContext Editor to call the .exe file of the application, I
received an error message that the Editor couldn't read the sources for
the .exe file (although I was successful with other unrelated .exe
files).
* Could you please share any experience with the QuickContent and
QuickFix tools of Forehelp?
* Is this where I need to go to integrate the two IDs (the app and the
help file) automatically?
* What is the "best" way to quickly create the context-sensitivity
between the application and the help file. What files should I export to
the SME and/or what files should I import from the SME?
* How to handle changes to the application after the help file has been
constructed, and can the Context tools be used BEFORE the application is
completed?
* What could be reasons that the QuickContext Editor couldn't open the
application sources?
* What parts of the online help file can be safely placed in
SourceSafe?