4.6. Tips and tricks

To support the external referencing of help pages, the system checks for help pages during startup. Since the context help system prior to 6.1 used the page name as the only identifyer, the external referencing mechanism will also work only with the page name and no bundle reference.

The problem is that this requires unique page names. So it is best to follow a naming scheme that creates unique page names. Don't use just help.html or edit.html as help page names, add something else to make it more clear. E.g. use myprj-general.html and myprj-form-edit.html. This makes it also easier to find your page in eclipse.

It is also good to know that the index of available context pages are cached. Thus, when you add a new context page and did not shutdown eclipse, you have to flush the translation cache. This will also flush the context help cache. This is found in the administration view where you launch the translation tool.