An Evaluation of Critical Incidents for Software Documentation Design

Abstract

A technique to determine end-users' perception of the documentation of a system can help documenters understand users' needs. Documenters can reflect this understanding in their documentation design, thereby increasing communication between designers and users. This study investigates the use of critical incidents as a mechanism to collect end-user reactions to software documentation, the presentation of this information to systems designers, and the effectiveness of critical incidents as a tool in an iterative process of online and hardcopy documentation design. The principle purpose of this study was the development and validation of critical incidents as an effective tool for the incorporation of end-user feedback into the simultaneous design and evaluation of both online and hardcopy documentation.

Get full access to this article

View all access options for this article.

References

Andersson

Nilsson

(1964). Studies in the reliability and validity of the critical incident technique. Journal of Applied Psychology, 48, 6, 398–403.

Cooper

J.B.

Long

C.D.

Newbower

R.S.

Philip

J.H.

(1982). Critical incidents associated with intraoperative exchanges of anesthesia personnel. Anesthesiology, 56. 456–461.

Dzida

Herda

Itzfeldt

W.D.

(1978). User-perceived quality of interactive systems. IEEE Transactions on Software Engineering, SE-4, 4, 270–276.

del Galdo

E.M.

Williges

R.C.

Williges

B.H.

Wixon

D.R.

(1986). A critical incident evaluation tool for software documentation. Presented at Third Mid-Central Ergonomics/Human Factors Conference, Miami University, Oxford, Ohio, June 18–20, 1986.

Fitts

P.M.

Jones

R.E.

(1947). Psychological aspects of instrument display. 1: Analysis of 270 “pilot error” experiences in reading and interpreting aircraft instruments. In Sinaiko

H.W.

(Ed.), Selected papers on human factors in the design and use of control systems(pp. 1–38). New York, Dover Publications, Inc.

Gould

J.D.

Lewis

(1985). Designing for usability: Key principles and what designers think. Communications of the ACM, 28, 3, 300–311.