Shannon Ford <shannon -at- UNIFACE -dot- NL>
Tue, 4 Jan 1994 17:42:27 +0100
The following bibliography was compiled from recommendations by participants
of the TECHWR-L list. Please excuse any repetition or spelling errors.
Jan V. White. EDITING BY DESIGN. 2nd edition, (R. R. Bowker Co., 1982). (2
John Brockman. WRITING BETTER USER DOCUMENTATION, 2nd Edition.
(Wiley, 1990). ISBN 0-471-62260-5 (29.95). (2 VOTES)
Thomas Bivins and William E. Ryan. HOW TO PRODUCE CREATIVE
PUBLICATIONS: Traditional Techniques and Computer Applications. (NTC
Business Books, 1991).
Jonathan Price and Henry Kormans. ("entitled something like") HOW TO
EXPLAIN TECHNICAL INFORMATION.
Brown, Richard Harvey. SOCIETY AS TEXT. Chicago: Univ. of Chicago Press,
GUIDELINES FOR DOCUMENT DESGNERS, David Felker et al., American
Institutes for Research, 1055 Thomas Jefferson Street, NW, Washington, DC 20007.
This text was a product of the Document Design Project that was funded by the
National Institute of Education. (ORDERS: Document Design Center/American
Institutes for Research/3333 K Street, NW/ Washington DC 20007; $12.95)
DESIGN PRINCIPLES FOR DESKTOP PUBLISHERS, Tom Lichty, Scott,
Foresman and Company, 1989.
For a good overview of document design principles, and a helpful bibliography,
see Martha Andrews Nord and Beth Tanner's chapter "Design That Delivers" in
the Barnum and Carliner collection TECHNIQUES FOR TECHNICAL
COMMUNICATORS (Macmillan, 1993).
Nobody talks much about "document packaging"--but I see that as an important
part of document design: What format should the thing be? Online vs. print?
brochure vs. pocket folder vs. looseleaf binder vs. bound booklet vs. hypertext
(interactive vs. non) vs. GIF file vs. e-mail. Etc. Etc. I like Michael
discussion of this issue in his 1989 TECHNICAL COMMUNICATION article on
designing for real audiences.
One book I've relied on for document design, document planning, and project
management guidelines has been Sandra Pakin & Associates' DDM: THE
DOCUMENTATION DEVELOPMENT METHODOLOGY. DDM is available in
soft cover for US$35.00 + US$5.00 for shipping from Sandra Pakin & Associates,
Inc. Publications Division 6007 N. Sheridan Road Chicago, IL 60660. Phone: (312)
271-2848. Sandra Pakin & Associates also publish _Folio_ a quarterly journal on
technical communication. It's available for US$60.00 per annum.
The best references I know of on the subject are the two books by Edward Tufte,
THE VISUAL DISPLAY OF QUANTITATIVE INFORMATION and
Jan White's GRAPHIC DESIGN FOR THE ELECTRONIC AGE (Watson-Guptill,
William Horton. ILLUSTRATING COMPUTER DOCUMENTATION: The Art of
Presenting Information Graphically on Paper and Online. (Wiley and Sons, 1991).
Theodore, E. Conover. GRAPHIC COMMUNICATION TODAY. (St. Paul, MN:
West Publishing, 1985).
Also good on basic design is James Hartley's DESIGNING INSTRUCTIONAL
TEXT (2nd ed., Kogan Page, 1987)--there might be a third edition of this, though
haven't seen it. Hartley's discussion is more traditionally focused on print
instructional text--but helpful nonetheless.
A.J. Romiszowski. DESIGNING INSTRUCTIONAL SYSTEMS: Decision Making
in Course Planning and Curriculum Design. (Kogan/Page, 1981). "It's OLD!, but
still has useful material."
Barbara Seels and Zita Glasgow. EXERCISES IN INSTRUCTIONAL DESIGN.
If you haven't already heard about it, try Gloria Grey's MAKING CBT HAPPEN.
It's got good theory, good design hints, and a good bibliography. Also, it's
available in paperback for a reasonable price.
John Carroll. THE NURNBERG FUNNEL, DESIGNING MINIMALIST
INSTRUCTION FOR PRACTICAL COMPUTER SKILL (MIT Press, 1990).
Williams Horton. DESIGNING AND WRITING ONLINE DOCUMENTS.
T. M. Duffy, J. E. Palmer, B. Mehlenbacher. ONLINE HELP: DESIGN AND
EVALUATION. (Ablex, 1992). ISBN 0-892-91858-X (~25.00)
USER-INTERFACE DESIGN CONSIDERATIONS FOR CD-ROM by Teresa T.
Lau, Sun Microsystems Computer Corporation.
ELECTRONIC AUTOMATION AS AN ALTERNATIVE TO LEARNING
COMPUTER TASKS by Robert Kruss, Daniel Dionne, and Elizabeth Weise,
Rensselaer Polytechnic Institute.
"Costs and benefits of interactions as a factor in users' choices of access
to online documentation" by T.T. Corey and R.B. Nonnecke, J.M. Mitterer, Dov
Lungu of IBM Canada Laboratory.
ELECTRONIC STYLE, A GUIDE TO CITING ELECTRONIC INFORMATION by
Xia Li and Nancy Crane (research librarians) ISBN 0-88736-909-X $15.00
A MANUAL OF STYLE, commonly known as the CHICAGO STYLE MANUAL
or just "Chicago."
WEBSTER'S STANDARD AMERICAN STYLE MANUAL. It complements
APPLE PUBLICATIONS STYLE GUIDE from APDA, 1-800-282-2732 (U.S.), 1-800-
637-0029 (Canada), (716) 871-6555 (Intnl).
INDEXING AND ABSTRACTING IN THEORY AND PRACTICE by F. W.
Lancaster (ISBN 0-87845-083-1) is a textbook. It won the 1992 award for best
information science book from the American Society for Information Science. It's
strong on theory, not as strong on practical information.
INTRODUCTION TO INDEXING AND ABSTRACTING by Donald and Ana
Cleveland (ISBN 0-87287-677-2) has a lot of good information, including
INDEXING FROM A TO Z by Hans Wellisch (ISBN 0-8242-0807-2) is my current
favorite. The blurb I have here says it's "an encyclopedic work covering basic
indexing techniques, author-publisher-indexer relations, business
editing and proofreading, computer-assisted indexing, and many other topics..."
This book has lots of practical, how-to information, and it's the one I refer to
most. However, like almost all books on indexing, it's short on information
indexing technical material.
American Society of Indexers (ASI) publications: contact the ASI Publications
Sales Office at P.O. Box 386, Port Aransas, TX 78373, (512) 749-4052, FAX (512)
6334.. Publications include FREELANCERS ON STARTING AND
MAINTAINING AN INDEXING BUSINESS, GENERIC MARKUP OF
ELECTRONIC INDEX MANUSCRIPTS, A GUIDE TO INDEXING SOFTWARE,
INDEXING: A BASIC READING LIST, INDEXING BIOGRAPHIES AND OTHER
STORIES OF HUMAN LIVES, and INDEXING FROM A TO Z.
Aristotle. The Rhetoric and Poetics of Aristotle. trans. by W. Rhys Roberts. New
York: The Modern Library, 1984.
Cicero. De Oratore. Trans. by E. W. Sutton. Cambridge, Mass.: Harvard
UniversityPress, 1959. ------. Orator. trans. by H. M. Hubbell. Cambridge,
Harvard Univ. Press, 1988.
Cox, Barbara G. and Charles G. Roland. "How Rhetoric Confuses Scientific
Issues." IEEETransactions on Professional Communication 16, no. 3 (1973): 140-
Dragga, Sam and Gwendolyn Gong. Editing: The Design of Rhetoric.
Amyityville, NewYork: Baywood Publishing, 1989.
Gates, Rosemary L. "Understanding Writing as an Art: Classical Rhetoric and the
CorporateContext." The Technical Writing Teacher, 17, no. 1 (1990): 50-61.
Halloran, S. Michael and Annette Norris Bradford. "Figures of Speech in the
Rhetoric ofScience and Technology." Essays on Classical Rhetoric and Modern
Discourse, edited byRobert J. Connors, Lisa S. Ede, and Andrea A. Lunsford.
Carbondale: Southern UniversityPress: 1984.
Halloran, S. Michael. "Technical Writing and the Rhetoric of Science." The
ofTechnical Writing and Communication 8, no. 2 (1978): 77-88.
Harris, Elizabeth. "In Defense of the Liberal-Arts Approach to Technical
CollegeEnglish 44, no. 6 (1982): 628-636.
Killingsworth, M. Jimmie. "The Essay and the Report: Expository Poles in
TechnicalWriting." Journal of Technical Writing and Communication 15, no. 3
Leff, Michael C. "Modern Sophistic and the Unity of Rhetoric." in The Rhetoric
theHuman Sciences, edited by John S. Nelson, Allan Megill, and Donald N.
McCloskey. Madison: University of Wisconsin Press, 1987.
Lunsford, Andrea A. "Classical Rhetoric and Technical Writing." College
Composition andCommunication 27, no. 3 (1976): 289-91.
Mitchell, John H. "It's a Craft Course: Indoctrinate, Don't Educate." The
WritingTeacher 4, no. 1 (1976): 2-6.
Miller, Carolyn R. "A Humanistic Rationale for Technical Writing." College
English 40, no.6 (1979): 610-617.
Plato. Gorgias, trans. by W. C. Hembold. New York: MacMillan, 1988. Rude,
Carolyn D. "Word Processing in the Technical Editing Class." The Journal
ofTechnical Writing and Communication 15, 2, 1985. 181-190.
Samuels, Marilyn Schauer. The Technical Writing Process. New York: Oxford
UniversityPress, 1989. ------. "Technical Writing and the Recreation of
Journal of Technical Writing andCommunication 15,no. 1 (1985): 3-13.
Shaw, Margaret. "Some Applications of the New Rhetoric to the Teaching of
TechnicalWriting: An Alternative to the Product Model." In Technical
Communication: Perspectivesfor the Eighties, edited by J. C. Mathes and Thomas
E. Pinelli. Hampton,, Va.: NASA,1981, pp. 461-66.
Tebeaux, Elizabeth. "Courses to Meet the Communication Needs of Writers in
Business andIndustry." CollegeComposition and Communication 36, no. 4 (1985):
"Let's Not Ruin Technical Writing, Too: A Comment on the Essays of Carolyn
Millerand Elizabeth Harris." College English 41, no. 7 (1980): 822-29. Nick
Lilly -at- Tarleton Tarleton State University Stephenville, Texas
References on warnings, cautions, and product liability, both from *IEEE
Transactions in Professional Communication*:
"Do Not Grind Armadillo in This Mill." 28.4 (Dec. 1985): 30-37.
"Human factors, Instructions and Warnings, and Products Liability," 30.3 (Sept.
"Armadillo" is by David N. Dobrin and is reprinted (and expanded I gather) in
his book *Writing and Technique* (Urbana, IL: NCTE, 1989).
Mail order for software
Here are three sources I have purchased "old" and "ancient" software from in the
past. Note: These distributors sell almost entirely for the DOS and/or Macintosh
operating systems (and mostly DOS at that).
Surplus Software International, Inc. 489 North 8th Street Hood River, Oregon
97031 800.753.7877 (voice) 503.386.1375 (voice) 503.386.4227 (fax) Products:
software and hardware for DOS and Macintosh
DAMARK 7101 Winnetka Ave. P.O. Box 29900 Minneapolis, Minnesota 55429-
0900 800.729.9000 (voice) 612.535.8880 (voice) 612.531.0281 (fax) Products:
Electronics, computers, computers peripherals and software.
DAK Industries, Inc. 8200 Remmet Ave. Canoga Park, California 91304
800.325.0800 (voice) 818.888.2837 (fax) Products: Electronics and computers,
occasionally some software.
Previous by Author:
Re: Self-study suggestions
Next by Author: Re: Telecommuting
Previous by Thread: STC Lone Star Chapter Winter Seminar--"Operating Your Environment"
Next by Thread: Re: Bibliography-long post
Search our Technical Writing Archives & Magazine