Cognitive Processing, Text Linguistics and Documentation Writing

Barbara Mirel Illinois Institute of Technology

Abstract

Software documentation is a growing field in technical writing, yet no synthesis of current research exists to bring together findings on content, form, and the invoked relationship between reader and writer. Without such an overview writers are apt to follow discrete, context-free prescriptions instead of guiding principles that account for the multidimensional functions of language in the communication act of a user's manual. This article reviews findings from research in cognitive processing and text linguistics to derive such a set of principles. It then assesses a widely-used wordprocessing manual against these principles to find that the writers manipulate form (the textual function of language) to achieve comprehension better than they do content (the ideational function) or reader-writer relationships (the interpersonal function). However, comprehension is stymied without equal attention paid to ideational and interpersonal strategies.

Journal
Journal of Technical Writing and Communication
Published
1988-04-01
DOI
10.2190/20jv-5n1e-6lnr-443u
Open Access
Closed
Topics

Citation Context

Cited by in this index (1)

  1. Journal of Technical Writing and Communication

Cites in this index (2)

  1. Journal of Technical Writing and Communication
  2. Journal of Technical Writing and Communication
Also cites 12 works outside this index ↓
  1. 10.3758/BF03331194
  2. 10.1037/h0037045
  3. 10.1007/BF00121082
  4. 10.2307/1121842
  5. 10.1007/BF00120935
  6. 10.1177/001872088302500202
  7. 10.1109/TPC.1981.6447818
  8. 10.1016/S0166-4115(08)62684-9
  9. 10.1080/01638537809544441
  10. 10.1016/S0022-5371(79)90594-2
  11. 10.1016/S0166-4115(09)60039-X
  12. 10.7208/chicago/9780226056043.001.0001
CrossRef global citation count: 6 View in citation network →