Notes toward a socially informed pedagogy for computer documentation

ABSTRACT

This article extends Johnson-Eilola's main argument and then, using a thought experiment, examines an extended example of its implications. The experiment follows a student who learns how to produce technical communication artifacts following the philosophy that informs most technical communication classes and that leads to production of the functional but not conceptual systems Johnson-Eilola critiques. The article concludes by recommending changes in overall curricula and in individual courses that would better educate communicators to account for the social implications of their work.

REFERENCES

• 1: Bernhardt, S. A. (1992). The design of sexism: The case of an army maintenance manual. IEEE Transactions on Professional Communication, 35(4), 217-221.
• 2: Boiarsky, C., and Dobberstein, M. (1998). Teaching documentation writing: what else students---and instructors---should know. Technical Communication, 45(1), 38-46.
• 3: Brasseur, L. E. (1993). Contesting the objectivist paradigm: gender issues in the technical and professional communication classroom. IEEE Transactions on Professional Communication, 36(3), 114-123.
• 4: Johnson, R. R. (1996). Tales from the crossing: professional communication internships in the electronic workplace. In P. Sullivan and J. Dautermann (Eds.), Electronic literacies in the workplace: Technologies of writing (238-252). Urbana, IL: National Council of Teachers of English.
• 5: MacKinnon, J. (1993). Becoming a rhetor: developing writing ability in a mature, writing-intensive organization. In R. Spilka (Ed.), Writing in the workplace: New research perspectives (pp. 41-55). Carbondale, IL: Southern Illinois University Press.
• 6: Sauer, B. A. (1994). Sexual dynamics of the profession: Articulating the ecriture masculine of science and technology. Technical Communication Quarterly, 3(3), 309-323.
• 7: Winner, L. (1986). The whale and the reactor: A search for limits in an age of high technology. Chicago: University of Chicago Press.
• 8: Terry Winograd, Documentation, interaction, and conversation, ACM SIGDOC Asterisk Journal of Computer Documentation, v.23 n.4, p.3-7, Nov. 1999 [doi>10.1145/339119.339123]

INDEX TERMS

Primary Classification:
  H. Information Systems
  H.5 INFORMATION INTERFACES AND PRESENTATION (I.7)
      H.5.2 User Interfaces (D.2.2, H.1.2, I.3.6)
          Subjects: Training, help, and documentation

Keywords:
documentation, online help, user interface