CogentHelp is a prototype tool for authoring dynamically generated on-line help for applications with graphical user interfaces (GUIs) built using the tract Windowing Toolkit (AWT). In this paper, we describe some of the techniques used in CogentHelp to facilitate the authoring, maintenance and customization of high-quality help systems. These include the use of (1) a “single-source” methodology for developing program code and help text; (2) small-grained, reusable “snippets”of help text instead of monolithic topics; and (3) a lightweight, extensible framework for planning and generating help topics from “snippets”.
David E. Caldwell, Michael White