A documentation team has several responsibilities when delivering context-sensitive help content.
Its primarily responsible to:
- Develop context-specific help content and context-specific help search
expressions for appropriate UI help contexts.
- Define the concrete help context ID strings that associate abstract help
contexts with context-specific help content.
- Create the Java properties files that define the mapping of abstract help
contexts to concrete help context IDs.
- Create the context-sensitive help UA plug-ins that contribute Eclipse context
XML files and the Java properties files.
- Test the context-sensitive help UA plug-ins and online documentation plug-ins,
with UI components provided by Development teams.
Documentation teams should rely on the Java source files (for the helpKey
constants interface classes) as the original and definitive sources of all
helpKey constant strings.
Creating the Java properties files can be somewhat automated (that is, by
processing the Java source files with a simple Perl script).
Most of the other artifacts required for a context-sensitive help UA plug-in can
be generated by XSL transformations of a DITA-XML map document.