Process for Context-Sensitive Help

The process that you follow for context-sensitive Help (CSH) depends on whether you or the software developer creates the header file.

If Author Creates Header File

  1. Author Add a header file to the project.
  2. Author Add an alias file to the project. The alias file lets you populate the header file through a user-friendly interface.
  3. Author Create and assign identifiers (IDs).

    (Optional for HTML5) Create a skin to use in CSH, set an ID for it, associate it with the appropriate IDs, and in the target set all skins to be generated.

  4. Author Associate the alias file with the target. This is necessary only if you have created more than one alias file.
  5. Author Provide the developer with a copy of the header file (or at least the CSH IDs within it) and the skin ID (if you are using one).
  6. Author Generate output and provide the developer with a copy of the output files.
  7. Developer Make CSH calls using information in the header file and the skin ID, if applicable.
  8. Developer Create a new build of the software application.
  9. Author Install the new software build and test the CSH.

If Developer Creates Header File

  1. Developer Create the header file (or at least individual CSH IDs) and send to the author.
  2. Author Add the developer's header file to the project.
  3. Author Add an alias file to the project. The alias file lets you populate the header file through a user-friendly interface.
  4. Author Assign IDs for the header file.

    (Optional for HTML5) Create a skin to use in CSH, set an ID for it, associate it with the appropriate IDs, and in the target set all skins to be generated. Provide the developer with the skin ID.

  5. Author Associate the alias file with the target. This is necessary only if you have created more than one alias file.
  6. Author Generate output and provide the developer with a copy of the output files.
  7. Developer Make CSH calls using information in the header file and the skin ID, if applicable.
  8. Developer Create a new build of the software application.
  9. Author Install the new software build and test the CSH.

What’s Noteworthy?

Note If you are generating Eclipse Help, there are additional steps that you need to complete in Eclipse. See Additional Steps for Eclipse Help.