Article Options
Premium Sponsor
Premium Sponsor

 »  Home  »  .NET Framework  »  Product Review: ComponentOne's DocToHelp  »  Summary
 »  Home  »  Reviews  »  Software Reviews  »  Product Review: ComponentOne's DocToHelp  »  Summary
 »  Home  »  Visual Studio 2005  »  Product Review: ComponentOne's DocToHelp  »  Summary
Product Review: ComponentOne's DocToHelp
by Scott Waletzko | Published  07/14/2006 | .NET Framework Software Reviews Visual Studio 2005 | Rating:
Scott Waletzko

Scott Waletzko has been an Information Technology professional and Windows / Web programmer since 1995, with experience in software development and architecture, network design and administration, and project and team management. Currently he is the the Senior Vice President of Technology at Intellisponse, as well as the President of Skystone Software / Echosoft Design Studios, LLC.

At Intellisponse, Scott is responsible for architecture and implementation of the company flagship software called Synapse, the first full-featured Web survey authoring tool for market research, enabling researchers to design, publish, and manage full-featured and logically complex questionnaires to the Internet without programmer interaction.

As president of Skystone Software / Echosoft Design Studios, LLC, Scott is developing a unique Web site content management system named Tempest, which will drive myBard.com and provide comprehensive Web site hosting and content management to anyone with a Web browser.

 

View all articles by Scott Waletzko...
Summary

Product Quirks

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.

Pros
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.

Personal Preference
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.

Cons
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.

Verdict
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

How would you rate the quality of this article?
1 2 3 4 5
Poor Excellent
Tell us why you rated this way (optional):

Article Rating
The average rating is: No-one else has rated this article yet.

Article rating:3.14583333333332 out of 5
 48 people have rated this page
Article Score25536
Sponsored Links