I'll be the first to admit - I am not a patient person by default. DocToHelp, however, continually tried my patience as I used it, severely reducing my perception of its overall usability. I tested the software on a laptop with an Intel 1.73 GHZ Pentium-M and 2 GB of RAM (my development machine) and despite this computing power it had an annoying habit of continually locking up as I interacted with the user interface. This behavior was so prevalent that it got to the point where I would click something in the user interface and then go browse the Web while I waited for the software to catch up. Worse than blocking itself, however, any intesive process (like building output files or converting assemblies in the Documenter for .NET) would slow my entire computer down to the point where it would take over a minute for me to open a new browser window.
My guess is that the speed issue has to do with the fact that the source documents for help files are Word or HTML documents, and therefore have to be parsed each time a new request is made. Summary
DocToHelp by ComponentOne is an ambitious product, attempting to provide a one-stop solution for any help file authoring needs, which it accomplishes to a certain extent. The conversion types, Documenter for .NET functionality, and comprehensive output options provide a wide range of features that facilitate creation of rich and consistent documentation for software.
Documenter for .NET provides a quick and easy way to create help documentation for a development library simply by choosing the assemblies to include in the documentation and then choosing an output type. This feature alone makes the document invaluable to .NET developers who wish to document their class libraries (assuming that the proper attributes were added to the source code in order to generate a comprehensive Xml comment file for each assembly).
The product is highly customizable in that custom document templates or style sheets can be used to create default source documents, and the compile behavior of individual styles can be modified using VB Script. This means that the longer a user works with the product, the more it will learn to suit their needs.
Not having used any previous versions of ComponentOne's help file authoring software (or even a competitive document-based authoring system), I found the learning curve associated with manipulating the source files to be a bit high, especially if you prefer to work with HTML source files and do not use FrontPage or DreamWeaver. My personal preference (and this is purely subjective) would be to work in an outline format. DocToHelp attempts to supply this with its table of contents and index views, but ultimately no matter how you approach the source document you are still editing it in either Word or an HTML editor. To be fair, anyone who has already become comfortable using a document-based help authoring system will likely feel more at home than I did with the DocToHelp interface, and the styles included are intuitively named, for the most part.
Whether you love or hate the document-based (as opposed to outline-based) authoring approach, there is no getting around the problems with responsiveness in the user interface of this product. During the course of my evaluations I created two different documentation projects: one based on a simple class library assembly, the other based on a complex class library project made up of 8 different assemblies. The smaller project was unresponsive enough to cause frustration pretty much every step of the way (including throughout the Documenter for .NET import process), and the larger project was virtually unusable because of the amount of time it took for each interface request to be responded to by the program.
Compile times for each project were quite long (depending on the output type), but that is for the most part understandable, and since compiling the output is not done until the end of a project, is also not a huge problem. Having to wait for the interface to respond as I tried to edit the document and otherwise navigate through the user interface, however, was unforgivable.
The multitude of output options makes this an attractive solution for software documentation requirements. With DocToHelp, a multitude of output types (online help, Web help, and printed manual) can all be generated from a single source file. The Documenter for .NET automates manual documentation of code libraries and is therefore invaluable to developers. Despite DocToHelp's frustrating usability issues, I am sure that I will be using this product again in the future simply because it is so versatile and has so many options.
If you are in the market for a help authoring tool, the well-roundedness of this product makes it a strong contender, but I would suggest demoing both this and competitive products before making a purchase to be sure that if DocToHelp is your final selection you can get past the quirks in order to benefit from the variety of features.
DocToHelp | Manufacturer: ComponentOne | Feature List | Price List