Cognitive Processing, Text Linguistics and Documentation Writing
Author:
- 1 April 1988
- journal article
- research article
- Published by SAGE Publications in Journal of Technical Writing and Communication
- Vol. 18 (2) , 111-133
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.Keywords
This publication has 14 references indexed in Scilit:
- Document Design for Technical Job Tasks: An EvaluationHuman Factors: The Journal of the Human Factors and Ergonomics Society, 1983
- Towards a Processing Account of Reference1982
- Opinions and Attitudes in Discourse Comprehension1982
- Making Legal Language Understandable: A Psycholinguistic Study of Jury InstructionsColumbia Law Review, 1979
- Integration of knowledge from textJournal of Verbal Learning and Verbal Behavior, 1979
- Feeding the information eaters: Suggestions for integrating pure and applied research on language comprehensionInstructional Science, 1978
- Linguistic considerations in the simplification/clarification of insurance policy language∗Discourse Processes, 1978
- Communication in Technical WritingJournal of Technical Writing and Communication, 1978
- Presenting technical information: A survey of research findingsInstructional Science, 1977
- Written information: Some alternatives to prose for expressing the outcomes of complex contingencies.Journal of Applied Psychology, 1973