Table of Contents

Introduction: Research Sources in Software Documentation Thomas T. Barker

PART 1: INQUIRIES
Education and Research
Prologue for Teaching Software Documentation Henrietta Nickels Shirk

Style and Software Documentation: A Central Concern Cynthia L. Selfe

The Influence of Cognitive Science
A Schematic Approach to User Knowledge and Software Documentation Production Jay Lieberman

Cognitive Writing: A New Approach to Organizing Technical Material Paula Bell

Issues of Design
Software Documentation and Human-Factors Design Joe Chew

The Hidden Effects of Computer Engineering on User Documentation Andrew Oram

Problems of Form in Software Documentation Nancy E. Cohen

PART 2: INNOVATIONS
Managing Software Documentation
Building and Managing a Documentation Project Team D. Michael Willoughby

Side-by-Side: A Model for Simultaneous Documentation and System Development Doann Houghton-Alico

Automated Documentation: A Complete Cycle Helen D. Klein

Improving the Quality of Software Documentation
Process Implementation—The Key to Quality Documentation Scott E. Hubbard

Information Product Testing: An Integral Part of Information Development Roger A. Grice and Lenore S. Ridgway

Software Documentation of the Future—Online
Writing and Editing Online Information Marlene C. Semple

Online Reference System Design and Development Bruno Petrauskas

Index

Contributors