Computing Reviews
Today's Issue Hot Topics Search Browse Recommended My Account Log In
Review Help
Search
Bullet proof documentation
Cady D., McGraw-Hill, Inc., Hightstown, NJ, 1996. Type: Book (9780070096318)
Date Reviewed: Dec 1 1996

The jacket says, “If you’re interested in a career that’s bursting with potential, you’ll find an enlightening discussion of the role of document testers in today’s and tomorrow’s business world.” This is good ad copy, and it does describe some of the content, but it is not what the book’s title implies.

An introduction to document testing fills the first 50 pages. It is followed by 50 pages on “documentation testing and the development process” and 30 pages on “preparing for a documentation test.” It is not until page 131 that we get to “conducting documentation tests” and “reporting and following up” on results. The eager high school graduate will be pleased by the following section, on “becoming a documentation tester,” having surely been excited by his or her high school English teacher who knew about the exciting potential of the computer field. Better yet, the current documentor may look at chapter 7, hoping for insight into “starting a documentation testing group in your company,” or chapter 8, on “hiring a documentation test team.”

No doubt the author is an excellent document tester. No doubt testing of documentation is necessary to ensure quality. Unfortunately, I am not sure much testing of this book was done with the intended audience. It will serve no one other than the rank novice who is not even sure what documentation is all about. This book does not provide adequate coverage of documentation techniques (for that, see Horton [1]). The material intended for managers, for example on starting an internal group, is better served in many books on project management or organizational techniques. Readers of Computing Reviews can draw their own conclusions on any potential value contained herein.

Reviewer:  David Bellin Review #: CR120106 (9612-0968)
1) Horton, W. Designing and writing online documentation (2nd ed.): hypermedia for self-supporting products. Wiley, New York, 1994.
Bookmark and Share
  Featured Reviewer  
 
Training, Help, And Documentation (H.5.2 ... )
 
 
Documentation (D.2.7 ... )
 
 
Evaluation/ Methodology (H.5.2 ... )
 
Would you recommend this review?
yes
no
Other reviews under "Training, Help, And Documentation": Date
Designing and writing online documentation: help files to hypertext
Horton W., John Wiley & Sons, Inc., New York, NY, 1990. Type: Book (9789780471507727)
Feb 1 1992
Designing, writing and producing computer documentation
Denton L. (ed), Kelly J., McGraw-Hill, Inc., New York, NY, 1993. Type: Book (9780070164178)
Oct 1 1994
An integrated solution
Hutchinson M., Rockley A.  Systems documentation (, Waterloo, Ont., Canada, Oct 5-8, 1993)1471993. Type: Proceedings
Sep 1 1994
more...

E-Mail This Printer-Friendly
Send Your Comments
Contact Us
Reproduction in whole or in part without permission is prohibited.   Copyright 1999-2024 ThinkLoud®
Terms of Use
| Privacy Policy