I am running a project for several year –in fact it is the maintenance stage– and I am in the search of a solution for the help. In the starting of the project, our client gave us nine mega word files that contained the help. The result is that nobody look at them for impractical.
Like an ant, I am searching here and there for the best solution to this problem. And finally, I think I bumped into something I consider is the best solution. It consist on the following:
It allows you to have the following:
And you only will have to face one document. Once propertly configured the workspace with Docbook and set the infocenter, the result is a help information that can satisfy the needs of all your users, without spending a bucket on it.
I've cut and paste this document from the internet:
Here I will put my discovering over the issue. I am in the path of installing the infocenter as a web application on a normal WAS, because this project is run on WAS and I don't want to expose all the eclipse runtime to internet: this could endanger the security of the website. Following this line is this article:
Okay, I've discovered the first problems in this stuff. I made the same test that appear in the document of IBM.
The “problem” is that it is not easy to remove the help documentation of eclipse. You can edit the
helpData.xml file and comment out all the toc's that appear there, but this is not enough.
I suspect that you have to search in all the plugins directory, inside all the jar files all the
helpData.xml files and comment them out in order to get a “clean” infocenter, with only your documentation.