This article emphasizes the growing need for good technical communication in application program development, and relates the usability of program documentation to the productivity of computer systems. It describes in detail the process involved and the human thinking that must accompany the generation of high quality computer user documentation. The methodology described in this paper has been exercised by the author on two major interactive IBM application programs. However, the methodology should not be interpreted as an IBM discipline, and views expressed in this paper are those of the author.
Get full access to this article
View all access options for this article.
References
1.
Reading material listed here contains useful information related to the ease of use of computers.
2.
BethkeF. J.DeanW. M.KaiserP. H.OrtE., and PessinF. H., Improving the Usability of Programming Publications, IBM Systems Journal, 20:3, p. 306, 1981.
GilbT and WeinbergG. M., Humanized Input, Winthrop Publishers, Inc., 1977.
5.
HuckleB., The Man-Machine Interface, Guidelines for Better Interfaces: General Principles, Chapter 5, Savant Research Studies, 1981.
6.
MelansonF., Guidelines for Developing Your Documentation System, Guide 50, Session MA-33, Houston, Texas, 1981.
7.
ShneidermanB., Software Psychology, Human Factors in Computer and Information Systems, Winthrop Publishers, Inc., 1980.
8.
TomsR. K., Graphics to Illustrate Software, European Computing Congress, p. 489, May, 1974.
9.
TomsR. K., Human Factors in User Documentation, Information and Management, 5: 3, August 1982.
10.
TomsR. K., Human Factors and Technical Communication in Application Program Development, IEEE Professional Communication Society Conference, Boston, Massachusetts, October 1982.
11.
WagnerC.B., Quality Control Methods for IBM Computer Manuals, Journal of Technical Writing and Communication, 10:2, 1980.
