CompuServe Thread

#Windows Help Files

2 messages in this thread
#9506From: Atkin & AssociatesMay 10, 1994 7:37 AM
#9421-#Windows Help Files — declared parent_msg_num=9421, resolved parent_id points to #(none)
>> I assume then that your interest in Help files is as a medium for >> distributing and viewing electronic documents than as a means to document >> custom programs. If so, then you'll probably want to incorporate existing >> documents in the Help files you create. My mistake. I was not clear. I *think* I'm talking about both, but I would appreciate some help. I'm the documentor in our shop. I write the end-user guides for our custom applications; I help programmers write tech dox and I edit for clarity. We're sneaking into Windows development while maintaining our support for clients with DOS apps–the standard story, I guess. I anticipate two scenarios. Scenario One: A client requests a "customized" application and we decide the tools to use are Visual Basic and Access. Will I be able to hook into existing Access help to create add-on messages that provide more meaningful, context-sensitive help for users? Or can I maybe use bookmarks as a quick and dirty way to "customize" help files? Scenario Two: We are building a customized application from scratch and we decide to use Open Insight, which, to quote the marketing bumph, is a "repository-based Windows application development environment." (My apologies. This is not a plug. It's just that we develop apps in Advanced Revelation and OI is their new product, so *naturally* we get all the mail.) This tool allows me, I think, to use the Windows help compiler, but I suspect I'll be writing *much* more application-specific material and creating my own indexes, hypertext jumps, demos etc., all the while trying to maintain Windows' "look and feel." The effect I'm going for is that, while the app has been built from scratch, the user sees it as "just another Windows program." Am I right in my suspicions? Thanks, Doug Fine article on image management tools, BTW, and I enjoy your regular column. So "thanks" for those, too.
#9507From: paul bonnerMay 10, 1994 9:33 AM
#9506-Windows Help Files — declared parent_msg_num=9506, resolved parent_id points to #9506
Doug, No matter what development tool you're using, the process of calling a custom help file is fairly similar. Your applications responds to a user request for Help (clicking a Help button, pressing F1, or whatever) by calling WinHelp and instructing it to open a specific compiled Help file. In addition, your app will generally include a context string in its call to Help. A context string is just a marker within the Help file that tells WinHelp how to locate the page that you want to view in the Help file. It is possible to create a Help file using just the standard Windows Help compiler and an RTF (rich text format) file into which you've manually inserted all the context strings and other data that the Help compiler needs, but it's about as easy as building a bridge from New York to London using popsicle sticks. To create Help files efficiently and without tearing out all your hair, you need a good Help file authoring tool. Once again, I would recommend Doc-To-Help or RoboHelp, although there are certainly several other fine alternatives available. Paul