Computing Reviews
Today's Issue Hot Topics Search Browse Recommended My Account Log In
Review Help
Search
Designing and writing online documentation (2nd ed.)
Horton W., John Wiley & Sons, Inc., New York, NY, 1994. Type: Book (9780471306351)
Date Reviewed: Apr 1 1996

As the title suggests, this book is a practical guide to online documentation. The introductory chapter does well in identifying several different types of online documentation systems, such as help facilities, computer-based training modules, catalogs, and guided tours. Chapter 2 details the planning process, while chapter 3 goes into detail on access strategies. This topic is given inadequate thought in many systems I use, and I tend to favor a combination of many strategies where possible. This last point is glossed over, unfortunately, in Horton’s text. Chapters 4, 5, and 6 detail topical organization, links, and organizational structures, respectively. These are perhaps the core of the book, along with the following chapter on dialogues, and they are explained at the practitioner’s level of detail, with good use of supporting citations for those who wish to follow up in the literature. While the chapter on help systems offers little information, the computer-based training chapter, while short, offers useful ideas to product planners.

As the writer of a review that, while favorable, had some critical comments on the first edition of Horton’s popular book [1], I was somewhat surprised to be given the opportunity to review the second edition. As one who has long argued for the importance of traditional system documentation, I have supported new online documentation efforts with zeal.

I am pleased to report that major improvements have been made to this book. More attention is paid to multimedia formats, a new chapter explains the planning and management of online documentation, and many practical suggestions have been added throughout the text. The layout makes good use of graphics and white space, and makes the book easy to read. The references number 295, and appear to have been updated for the new edition. In fact, the reference pages are a treasure chest for those who wish to delve into the details of any topic covered in the book. The index is similarly thorough and complete. This book is an excellent update to what was already a title high on my recommended list for computer professionals who have a job to do and a product to document.

Reviewer:  David Bellin Review #: CR118982 (9604-0247)
1) Horton, W. Designing and writing online documentation: help files to hypertext. Wiley, New York, 1990.
Bookmark and Share
  Featured Reviewer  
 
Training, Help, And Documentation (H.5.2 ... )
 
 
Documentation (D.2.7 ... )
 
 
Multimedia Information Systems (H.5.1 )
 
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