Microcomputer Users' Preferences for Software Documentation: An Analysis

John M. Penrose San Diego State University ; Lawrence M. Seiford University of Massachusetts Amherst

Abstract

Fundamental requirements for good user documentation have not changed over the years. Manuals must be complete, accurate, clear, readable, and available on time. What has changed are tolerances and standards. Today's users—typically business professionals but even expert technicians and engineers—will no longer accept unreadable and inaccessible publications. The days of documentation with poor organization, limited graphic support, and poor aesthetics have passed. This article analyzes users' opinions and preferences for microcomputer software documentation. The results provide valuable guidance for software authors, designers, and publishers.

Journal
Journal of Technical Writing and Communication
Published
1988-10-01
DOI
10.2190/xnqg-n8ld-p1f2-2r0f
CompPile
Search in CompPile ↗
Open Access
Closed
Export

Citation Context

Cited by in this index (0)

No articles in this index cite this work.

References (18)

  1. How to Write Computer Manuals for Users
  2. The Complete Guide to Writing Software User Manuals
  3. Softwords, Hardwords: A Common-Sense Guide to Creative Documentation
  4. How to Write a Computer Manual: A Handbook of Software Documentation
  5. Writing and Analyzing Effective Computer System Software
Show all 18 →
  1. Documentation: The Paper Chase, PC Week, pp. 107–110, January 16, 1984.
  2. IBM, private interview
  3. Texas Instruments, private interview
  4. Weiss E. H., How to Write a Usable User Manual, ISI Press, Philadelphia, PA, p. 8, 1985.
  5. Chair, American National Standards Committee—Information Systems
  6. Working Draft, Standard for Software User Documentation
  7. SAS User's Guide: Basics, Version 5 Edition
  8. Penrose John and Seiford Lawrence M., Computer ‘Personalities’: A New Approach to Understanding User Compatib…
  9. Penrose John M., Bowman Joel, and Flatley Marie, The Impact of Microcomputers on the Association for Business…
  10. Penrose John and Muller Douglas, The Effects of Computer-Mediated Communication Systems on Writing, Journal o…
  11. Penrose John and Muller Douglas, A Qualitative Comparison of Three Microcomputer Business Letter Libraries, J…
  12. Penrose John and Muller Douglas, Telecommunications and its Relationship to Business Communication, Journal o…
  13. Penrose John and Muller Douglas, Student and Recruiter Views of the Importance of Computer Science, Interface…