Posted by brian10
on September 18, 2006 at 3:21 PM PDT
Hi Everyone -
We recently completed a swing application in which we created our JavaHelp helpset by authoring an XML document and using docbook's javahelp.xsl for transformation. As a developer, I loved the ease with which this allowed us to generate the helpset.
For version 2, however, our helpset will grow substantially and authoring via an XML document may not be realistic. Therefore we are about to begin evaluating tools that offer a more robust means of authoring the help document. RoboHelp currently tops the list because it is a familiar name (although no one on our team has used it).
A few questions:
1. Can you recommend any other tools that should make our evaluation list?
2. In your opinion, do these tools make help file authoring much easier? Or do they come with their own set of headaches (learning curve, gotchas, configurations, file management, etc.) that might outweigh the benefits?
3. Do most (especially RoboHelp) integrate nicely with JavaHelp? Some posts mention checklists before building the JavaHelp helpset. In your opinion, are these checklists straight forward?
4. Any lessons learned for a team that is about to start out?
Thanks in advance for your comments and insight.