A Modular Approach to WinHelp Projects: The Process Behind the Success  

The Knowledge Products group at Cisco Systems, Inc., provides online help for both PC and UNIX-based applications. The online help team for the Cisco Works for Windows product comprised of five writers who coordinated the online help development efforts. The online help team worked closely to produce an integrated help system that was modularized for better process control.

Mandavilli, Lavanya K. STC Proceedings (1996). Articles>Documentation>Online>Help

Planning and Creating a Windows Online Help System  

The basic requirements for creating accurate and useful technical documentation are good writing skills, an understanding of the audience, knowledge of the tools used for producing documentation, ability to use the product, and ability to successfully interview subject matter experts. While the same skills are essential for creating an online help system, writers also need to understand how help projects are set up, how to modify their writing to produce modular help topics, how to test the program-to-help links between the product and the help topics, and how to align help file development with engineering build dates. In addition, writers expand their hypertext awareness to include new terms such us jumps and pop-ups.

Mandavilli, Lavanya K. STC Proceedings (1995). Articles>Documentation>Online>Help