Synopses & Reviews
This popular handbook presents a step-by-step method for clearly explaining a product, system, or procedure. The easy-to-follow text--packed with examples and illustrations--explains the unique demands of this form of writing and shows how to set up the best user model. The book covers developing a modular outline and storyboard, generating the draft, revising, developing a formal usability test, and supporting and updating user documentation. Also included are a glossary of terms, a listing of books and periodicals for additional information, and an index.
Review
A readable, thought-provoking volume.Library Quarterly
Review
There may be guidance that pre-dates Weiss' book, but for me this represents the beginnings of user-friendly documentation. Anyone who has struggled through a manufacturer's manuals....needs to know that there is a better way to serve the customer....Effective documentation must factor in motivation....Wiess shows us how....The other problem with conventional documentation, is its internal organization. Instead of self-contained answers, one is forced to leaf from one partial explanation to the next....Weiss gets directly to the point. His answer is modularization. Each section must be short, focused, self-contained, and conceptually autonomous. It must be able to stand on its own, so that if the reader stops right there (wherever that is), he can resume reading without loss at a later point. YES!HTML Author
Description
Includes bibliographical references (p. 260-261) and index.
About the Author
EDMOND H. WIESS, Ph.D., is associate professor of communications for the Graduate School of Business Administration, Fordham University, New York, and an independent consultant and lecturer on technical writing, management communication, and documentation.