You are here:

A Study of Analogy and Person in Computer Documentation. Preliminary Report



Over the past several years, technical communicators have been struggling to change some of the stylistic traditions inherited from scientific discourse. Rhetoricians, writing teachers, and psychologists all agree that the use of analogy and first- or second-person sentence construction make for more effective communication than the absence of analogy and the use of the impersonal third person. However, established conventions and standards sometimes preclude inserting these stylistic devices into our material. With only an intuitive feel for the use of language, our arguments lack the substantive basis with which to change the standards. In order to examine the discrepancy between theory and practice, an experiment with computer documentation was conducted to measure the effects of analogy and second-person construction in learning, and another to assess whether these same stylistic devices were annoying to subject matter experts. The use of analogy made it easier for subjects to recall information without being cued; however, it had no effect on cued recall (recognition). Computer programmers were indifferent to the use of analogy (not hostile), and they preferred the second person sentence construction to the third person. (Author/JB)


Soderston, C. & German, C. A Study of Analogy and Person in Computer Documentation. Preliminary Report. Retrieved March 23, 2019 from .

This record was imported from ERIC on March 21, 2014. [Original Record]

ERIC is sponsored by the Institute of Education Sciences (IES) of the U.S. Department of Education.

Copyright for this record is held by the content creator. For more details see ERIC's copyright policy.