Journal of Technical Writing and Communication
644 articlesApril 1994
-
Abstract
Why are technical writers needed to “translate” the work of technologists into accessible communication? This article looks briefly at the situation that creates the need for technical writers and then argues for a change in that situation so technologists can communicate for themselves. The argument is based on Martin Heidegger's philosophy of meaning, language, and communication. It recommends greater, active involvement of technologists with the “real world” in which their technology will be used, including involvement with people with whom and for whom the technology is being developed. Key concepts presented are that meaning lies in socially-agreed relations among things in the world, not in words or in the relations between words and things; that language actually manifests rather than represents reality; and that technical writers are incapable of fully appreciating and communicating the meaning of what technologists do because they come from a different discipline which constructs meaning differently. It argues that a change in technology practice will engender a new attitude and approach to technical communication that can make technical writers unnecessary except as communication teachers who help develop the communication skills of technologists.
January 1994
-
Abstract
Evaluation of five editions of John M. Lannon's Technical Writing (1979–1991), one of the top-selling technical writing texts available to educators today, demonstrates not only where technical communication has been, but also where it is going. Lannon's book (and his comments in an interview) begins to shed some light on how one man's textbook on technical communication responded to social conditions in the 80s.
-
Abstract
This article describes the design and evaluation of a formal writing assessment program within a technical writing course. Our purpose in this base-line study was to evaluate student writing at the conclusion of the course. In implementing this evaluation, we addressed fundamental issues of sound assessment: reliability and validity. Our program may encourage others seeking to assess educational outcomes in technical writing courses.
-
Abstract
This study investigates The Treatise on Fishing with an Angle from The Book of Saint Albans to determine how a fifteenth-century author approached the problem of writing accurate, technical prose on angling, a subject never before treated in a written work. The examination reveals that many of the rhetorical features are similar to the practices of modern technical writing. For example, the treatise makes a determined effort to relieve user stress about the new technology it introduces. It also makes its information easier to understand by forecasting its organization and by using common, concrete, and consistent terminology. Finally, the treatise includes illustrations that supplement the text in ways similar to modern illustrations.
-
Abstract
Complex noun phrases, although key elements in technical writing for linguistically mature readers, also present major comprehension difficulties for others. This article establishes many important ways of paraphrasing complex noun phrases into simpler structures, and identifies the differences in meaning, style, is tone, and emphasis created by the paraphrases. Whereas many complex noun phrases at the start of the sentence can be easily paraphrased, those at the end of the sentence or embedded within the sentence present greater challenges. Similarly restrictive post-modifiers are easier to paraphrase than those that define. The principles are applied to a short legal text.
-
Abstract
Not along ago, I received a call from a colleague who teaches technical writing, among other things, in the department and university which gave our field John Mitchell, one of the founders of the Society for Technical Communication and an early definer of our field. My colleague wanted to know how my former department would value, in terms of tenure and promotion, a book on Boston Harbor nautical matters. His department did not value it at all, and unfortunately, neither would have mine. It is this experience, which is too often common to technical communication scholars, that prompts the question in this article's title.
October 1993
-
Abstract
Cues to text structure have been proposed to operate a number of different levels and it has been suggested that lower-level factors (e.g., word decoding) are more critical to reader performance than are higher-level factors (e.g., paragraph and text structure). The current study involved presenting texts in their base form and with cues to coherence at two levels—at the word and paragraph level—removed. These manipulations were performed on technical texts at two levels of familiarity and were presented to technical readers. Tests of recall, recognition, and problem-solving revealed that while removal of cues to local coherence did produce reliable decrements in reader performance, more dramatic effects occurred when both types of cues were removed. Results are discussed in terms of their relevance to questions of information design.
July 1993
-
Avoiding Desktop Disasters: Why Technical Communication Students should Learn about Mechanical Paste up Techniques ↗
Abstract
Today many students learn how to use desktop programs such as PageMaker and Ventura in technical communication courses; however, few of those students are also learning the principles of graphic design underlying the production of mechanicals. The ability to use a desktop publishing program does not necessarily guarantee the ability to produce well-designed and effective documents. In fact, the growing use of desktop publishing software has led to a proliferation of documents that violate all the rules of good design. This article describes a technical publications course in which students gain a better understanding of the principles of design and layout by using mechanical paste up techniques. When required to use mechanical paste up in addition to desktop publishing software, students acquired a more thorough understanding of grids and white space as well as a greater confidence in their abilities to do page design.
-
Medical Text and Historical Context: Research Issues and Methods in History and Technical Communication ↗
Abstract
Identifying problems in recent technical communication studies of historical medical text, this article suggests ways for researchers to overcome them. Its approach uses five steps for conducting sound historical research: establishing originality for historical textual analysis; adopting an authoritative text for analysis; understanding the genre or form of a historical text; understanding the intellectual or social context for a historical text; and understanding the publishing and readership context of a historical text. These steps are discussed within the context of related fields of inquiry, namely history of medicine, history of the book, literary criticism and historical linguistics, and analytical bibliography. The article concludes by exploring new directions for research in technical communication and history of medicine.
-
Abstract
This article discusses two conflicts occurring during the first decade of the Royal Society (1660–1670). One conflict concerned the proper method of scientific experimentation, the other the proper writing style for communicating scientific knowledge. Following the method proposed by taxonomists, language would be a vehicle for representing the order of reality in its undisturbed state. Following the method proposed by conjecturalists, language would be a means for constructing a theory and arguing for its validity. Members of the Society were divided over these crucial questions, as evident in scientific documents of the period as well as in Thomas Sprat's History of the Royal Society. Parallels to this division are present in contemporary issues in technical writing, and this article closes by discussing some implications for teaching, practice, and theory.
April 1993
-
Abstract
The case method of teaching is increasingly utilized as a tool for the teaching of business communication and technical writing. In addition to providing students with meaningful exposure to actual companies and written products, the use of cases challenge students to assume one or many various positions within an organization where effective communication with myriad publics is essential in meeting organizational goals and objectives.
-
Putting Trauma Care in Writing: Parallels between Doctors' and Nurses' Responsibilities and Textbook Presentations ↗
Abstract
The roles of physicians and nurses working in trauma centers are mirrored in their writing. Physicians must focus intensely on patients' injuries if lives are to be saved. Their professional prose is correspondingly, and appropriately, focused, with attention given to injuries and their repair. The doctors' partners in the admitting area, trauma nurses, adopt a holistic view, caring for patients' physiologic and psychologic stability. Nurses tend to be more comprehensive in their writing, describing patients as individuals, the families involved, and the threatening and encouraging events that emerge during recovery. Although the distance and impersonal nature of medical writing, as a subset of technical writing, is criticized by technical writing scholars, published works by trauma surgeons may require exactly those characteristics. Perhaps a reflection of that disparity, medical publishers give mixed messages regarding style to physicians and nurses who choose to be authors.
January 1993
-
Abstract
Twenty years ago I had no idea what a computer was. Ten years ago I knew what computers were, but I had never sat at a terminal. I just assumed that computers were machines used in those “other” disciplines, certainly not in English courses. Today, I teach my technical writing classes in a collaborative computer classroom. The classroom consists of twelve networked computers which my twenty-four students per class use in tandem. Despite my original ignorance of computers, I'm now happily ensconced in a computer classroom. In fact, computers are so important, I've concluded, that teaching writing without the aid of computers does our students a disservice. How did I make such a complete turn-around in attitude? I realized that far from being anathema, computers helped to create a perfect marriage for teaching and writing. First, computers let students write more effectively because computers are compatible with the writing process (writing and rewriting). Next, teaching students to write in a collaborative computer environment prepares our students for business and industry where they will be asked to work on group projects and to communicate electronically. Despite the values of computerizing our instruction, however, computers in the classroom present problems. Do the benefits outweigh the deficits? My answer is yes.
October 1992
-
Abstract
In recent years, a new pedagogical model has arisen in the teaching of technical writing, one of “technical writing as enculturation.” A close examination of this model reveals not only its relation to the workaday world of modern technology but also its roots in classical, especially Ciceronian, rhetoric. Our awareness that the model is both modern and classical may, in fact, enable us to carry its amplification and refinement even further.
-
Abstract
This article quantifies specific elements of technical writing style in five award winning technical manuals where combined averages for the style elements are calculated. When these results are compared to what is generally regarded as good technical writing, the results show that the elements of style vary widely between the individual manuals examined. While attempting to define a good technical writing style, the value of such studies must be commented on.
July 1992
-
Abstract
This article focuses on recruiters' perceptions of technical writers in terms of what information should be included in cover letters and resumes, as well as the roles of interviewees and interviewers in the employment interview. The results reveal that 1) the interviewee should include information in the cover letter that is not in the resume, that 2) employment history and educational background are the most important parts of the resume, that 3) communication skills, credibility, maturity and work experience are the most important dimensions of the interviewee, and that 4) the interviewer should present an overview of the position, job description, and short-and-long range department goals. Other results are discussed in the article.
-
Abstract
This article collects several examples of technical and creative writing in order to examine whether the differences which have been assumed to exist between the two genres do in fact exist. The formulation of such a dichotomy is traced from I. A. Richards' definition of “poetic vs scientific” writing through C. P. Snow's Two Cultures to Coleridge's Biographia Literaria (Richards' acknowledged source). Coleridge in turn has been shown to be heavily influenced by, in fact to have plagiarized, the work of German idealists, particularly the Schlegels. The German idealists, finally, were working with dichotomies which originate in Cartesian dualism and thus ultimately in the mind/body dichotomy with whose invention Nietzsche credits, or discredits, Plato. The differences and similarities discovered and discussed between the object texts turn out to be governed by Richards' elements of writing—“sense, feeling, tone and intention”—as these elements have been used to dichotomize technical and creative writing. Such previous formulations have attempted to show differences in what Aristotle termed “material cause.” The material causes—the tropes and devices of description—are in fact the same in technical and creative texts. The actual differences and similarities discovered between and among the object texts are, rather, differences governed by Aristotle's “final cause” ( telos).
-
Effects of Advance Organizers and Reader's Purpose on the Level of Ideas Acquired from Expository Text—Part II ↗
Abstract
Part I of this article, pp. 259–272, reviewed the relevant literature on advance organizers and suggested that methodological problems in previous advance organizer studies has not resolved the question of whether advance organizers facilitate the acquisition of subordinate information from text. This question is not an unimportant issue to technical communicators, whose readers often need to acquire factual information as well as more general concepts from the expository text they read. In two studies we investigated the influences of reader's background knowledge, advance organizers, relative importance of idea units, and idea units' position within a text structure on the recall of textual information. Subjects read introductory and text materials and subsequently were tested for their recognition of idea units that were structurally high and important, structurally high and unimportant, structurally low and important, or structurally low and unimportant. In the first study, forty-eight college students were randomly assigned to conditions consisting of relevant or irrelevant background, organizer or no organizer, and text or no text. There were significant main effects for having read a relevant text and for importance of idea units, and an interaction between structural level and importance. A significant organizer by text or no text interaction and absence of a significant main effect for the organizer indicated that the organizer influenced text processing rather than priming relevant prior knowledge, which is a previously undocumented requirement of advance organizer research. In the second study, conducted with eighty-eight college students, we substituted a purpose, no purpose condition for the text, no text condition of the first study. We observed a significant main effect for importance and a significant four-way interaction involving structure, importance, background, and organizer. The more relevant knowledge a reader had, the less dependent he or she was on text structure, and an advance organizer compensated for the absence of relevant prior knowledge.
April 1992
-
Abstract
Because of the work of Francis Christensen, sentence-terminal modification was emphasized in college composition from about 1965 to 1980. The structures emphasized included absolutes, restating and summarizing appositives, participial phrases, non-participial adjective phrases, adjectival clauses and prepositional phrases, and adverbial clauses and phrases. This emphasis, however, had little effect on technical writing, in spite of the practical utility of terminal modifiers. This article, therefore, explains the terminal modifiers and exemplifies them in the context of technical writing; it then examines the texts of representative technical reports to determine the extent to which terminal modifiers are currently used. The findings—generally that the report writers do not take full advantage of terminal modification—indicate that increased attention to terminal modifiers, especially the absolute, the summarizing appositive, and the non-participial adjective phrase, would significantly increase the options for effective expression by technical writers.
-
Abstract
Writing assignments for a graduate course in technical writing should develop students' technical backgrounds, their familiarity with reference materials, and their peer editing skills, as well as their writing skills. Also, the assignments should encourage students to write for publication. The three assignments described here—on a scientist, a topic in science, and a topic in technical communication—can help students achieve these objectives. Students write the first two articles for publication in general-audience newspapers or magazines, and the third for the same general audience or for a technical communication conference or journal.
January 1992
-
Abstract
There are differences of vocabulary, grammar, and usage in American English and British English. As international interchange of information increases, we must alert writers and editors to these differences, and encourage them to find forms of expression common to both versions of English. If they do not, their texts may create difficulties, not only for readers using English as a foreign language, but also for native speakers of American English or British English.
October 1991
-
Abstract
To make informed decisions about ethical issues, technical communicators need to understand how to apply general ethical principles to the kinds of dilemmas they will face routinely, concerning such issues as plagiarism, trade secrets, and misrepresentation of text and graphics. This article reviews the controversy about the relationship between ethics and rhetoric among the Greeks, provides basic definitions of ethics, and applies the literature of business and professional ethics to the concerns of technical communicators and other professionals who communicate, showing how they must think through the conflicts of obligations to their employer, the public, and the environment. It provides a case study that can be used to reinforce a student's understanding of the relationship between technical communication and ethics.
-
Abstract
Technical writing will become increasingly important to the nation's engineering interests in the 21st century. To meet a national agenda of competitiveness, writing program administrators must build courses and programs that are sensitive to unique institutional perceptions about writing. By means of a quantitative and qualitative methodology, the present study describes the perceptions of technical writing held by department heads at a technological university. Using a combined survey method and structured interview process, we investigate how department chairs felt about the contents, instruction, and assessment of a technical writing course. We also investigate perceptions about writing products and processes. Based on our experiences with the survey, we call for writing program administrators to study the institutional context for courses and programs in technical writing.
-
Abstract
Usability testing is now recognized as essential to quality documentation, but, unfortunately, the costs and the time required for fullblown testing are prohibitive for many projects. This article presents a set of very practical guidelines for a small documentation team to design and conduct its own usability study—including discussions of preparing task lists, recruiting participants, conducting the study, and analyzing the data.
July 1991
-
Abstract
Technical communicators are faced daily with digesting the results of research reports; however, many technical communicators do not have the training that would facilitate their comprehension of such reports, particularly the sections of research reports that cite statistical terminology. This article addresses the need of technical communicators to become critical readers of empirical research. Specifically, we present simple definitions of selected research designs and statistical concepts and accompany these definitions with concrete examples related to the field of technical communication research.
April 1991
-
History, Rhetoric, and Humanism: Toward a More Comprehensive Definition of Technical Communication ↗
Abstract
Recent research suggests that pragmatic emphasis on writing proficiency alone does not produce a good technical communicator. Attention must also be given to the technical communicator as liberally educated generalist who writes well and feels an affinity for science or technology. To this end, technical communication needs to be studied in the larger context of evolving science and technology, developing trends in technical education, and the oratorical tradition of broad learning applied to the active life. Recent studies of the collaborative culture of the workplace should be supplemented by increased attention to humanistic questions of what a person needs to be and know in order to cooperate effectively as a practicing technical communicator.
-
Abstract
The student new to technical writing frequently has difficulty, on two counts, with technical definitions: grasping their essentiality and learning how to create them; matters are not made easier by some of the ways in which we approach the subject. Exercises centered around a term that is lapsing into obsolescence offer some productive solutions to this common instructional problem, particularly so if the term is even indirectly related to the student's field.
-
Abstract
Researchers continue to miss useful references because of unsystematic methodology and because on-going efforts at systematic bibliography have not utilized some key resources. Although no combination of available resources guarantees comprehensive bibliographic coverage for technical communication, composition, or rhetoric, researchers can significantly improve their personal efforts by using citation indexes and a few other databases.
-
Abstract
Technical documents implicitly require readers to play out textually constructed roles in order to create meanings. Good technical writers create texts that motivate their readers by emplotting them in an attractive fabula, and, especially, in a role that not only achieves the ostensible purposes of the documentation but also allows the reader to function as the hero in a narrative of progress and improvement. Drawing on reader-response criticism and narratology, this article shows how a particular instructional software manual, the VP-Expert™ guide, instructs and motivates readers by using devices which resemble the conventions of heroic narrative.
-
Infusing Practical Wisdom into Persuasive Performance: Hermeneutics and the Teaching of Sales Proposal Writing ↗
Abstract
Sales activities have been understood by some to be negative, one-sided rhetorical encounters. Teachers of technical communication will find it more helpful to view sales proposals as aimed toward the construction and maintenance of long-term relationships, a view held by far-thinking sales professionals. Hermeneutic theory, by offering a different conceptual relationship between means and ends than even new rhetoric suggests, can help clarify the process by which ethical know-how intersects with persuasion. Consequently, it can offer technical communication instructors a valuable perspective from which to teach sales proposal writing.
January 1991
-
Abstract
One approach to exploring context in technical communication is through the speech community. Composed of people who share the means and the need to communicate with each other, the speech community is essentially a social entity, its boundaries determined by feelings of commonality among the community's members. In considering the communication that occurs in a speech community, this article asks two general questions. First, what is the relationship among language, culture, and thought? Second, what knowledge is needed for effective communication? Answering the first question requires an exploration of the Whorfian hypothesis as it may apply to technical communication, while answering the second requires an expansion of Chomsky's grammatical competence to include language function and use and a broadening of Flower and Hayes's investigations of cognitive structures beyond the isolated experimental situation into the community.
-
Abstract
Examining the limitations of some common metaphors for technical communication and exploring new alternatives lead to a new definition of technical communication. In current studies of the field, four metaphors appear dominant through explicit or implicit use: transmitter, channel, balance, and bridge. But each of these metaphors is limited in some way when used to describe the field. These limitations arise from complexity, directionality, or originality of the process. Some alternatives provide a new way of viewing the field: lock, translator, transformer, synthesizer, conductor, and orchestrator. The latter term leads to a tentative definition of the field: Technical communication is the process of orchestrating linguistic, visual, or auditory codes to accommodate information to the user.
-
Abstract
While several strategies have been credited for enhancing the rhetorical acceptability of important historical works in scientific and technical writing, little attention has been paid to William Harvey's On the Motion of the Heart and Blood in Animals. A close examination of his work shows his fear of publication (because of his contemporaries' long-held beliefs about the order of the body and its functions) and his strategies for reducing resistance to his ideas: appropriate circular references and metaphors and organizational techniques that clarify and enhance not only his thesis—that the blood circulates through the body—but also demonstrate the circular pattern as part of God's natural order for the universe.
October 1990
-
Abstract
Instructions should be illustrated so as to help users memorize steps as quickly and thoroughly as possible. Classical mnemonic theory provides an excellent description of how to create such illustrations. The most detailed description of how to form memorable images that function as cues to subject matter is contained in the ancient Roman treatise Rhetorica Ad Herennium. The basic principle is that one must form bizarre, striking pictures combining cue images with images representing the words or concepts that are to be remembered. Much modern research on memory and imagery bears out the ancient wisdom on this topic. Gordon Bower, Allan Paivio, and others have shown that subjects remember lists of items far better when they use paired associate methods of visual memorization that are based on the classical theories. Other researchers, such as Margaret Hagen, have found that the mind processes information faster and remembers it longer when it has to deal with only minimal cues (for example, a simple line drawing as opposed to a photograph or a detailed drawing). Combining insights from ancient theory and practice with those from modern research, I suggest that technical communicators use, where possible, a particular kind of image to illustrate instructions.
-
Abstract
Harris argues that linguistic theory is useful for solving certain problems encountered in technical writing theory and pedagogy [1]. However, he undermines his purpose by introducing irrelevant distinctions between competing syntactic theories (Generalized Phrase Structure Grammar and Transformational Grammar) and by failing to exploit the full potential of the few applications he mentions. The passive rule is a case in point. It not only constitutes an operational test for identifying passive sentences, it also contributes to the flow of discourse by rearranging both thematic roles (e.g. agent and patient) and given/new information. The passive rule is only one of a class of noun phrase-moving operations that technical writing specialists may find useful.
-
The Effect of the Word Processor and the Style Checker on Revision in Technical Writing: What Do We Know, and What Do We Need to Find Out? ↗
Abstract
This article surveys and critiques the literature on using style checkers and the text-editing capabilities of the computer to assist in revising technical writing. The literature on text-editing capabilities is inconclusive because it is largely anecdotal and methodologically flawed. The literature on style checkers is similarly inconclusive. To better assess the value of the computer, we need to examine the basic premise of the research on revising and word processing: that more revising leads to higher-quality writing. We need to be sure that our evaluative techniques for measuring writing improvement are valid; to focus our attention not only on computer novices but also on computer-experienced writers; to examine other factors that affect how writers use word processing and that in turn might affect writing quality; and to examine more carefully the differences among word processors and among the different style checkers to determine their effects on writing behavior and writing quality.
July 1990
-
Abstract
Studies show that products are often judged defective for one or more of the following reasons: 1) manufacturing defects, 2) design defects, 3) inadequate warnings, and 4) inadequate instructions [1, p. 127]. The last two reasons are of particular importance to technical communicators, for we function as the information specialists who link the companies that make the products to the people who use the products. This article examines the relationship between warranties and product liability. It includes a discussion of American National Standards Institute (ANSI) guidelines for safety labels in the workplace and an analysis of warnings and labels as they apply to the pharmaceutical industry. In its closing section, the article discusses some of the key references that technical communicators can consult for additional information on product liability and safety labels.
-
Abstract
The claim that Geoffrey Chaucer was “the first technical writer in English,” which appears several times in the recent literature on the history of technical writing in early English, misleads because numerous Middle English technical prose texts either precede Chaucer's Treatise on the Astrolabe or are contemporaneous with it. In fact, an important tradition of technical writing exists in both Old and Middle English and extends through the English Renaissance. Historians of technical writing will find it more profitable to investigate the tradition of English practical prose than to find further firsts for their field.
-
Abstract
The visual dimension of meaning is widely accepted in technical communication. But theories (and pedagogies) that direct the making of visual meaning are still under development. A guidelines approach, a design decisions approach, and an information/reader model approach are applied as lenses for viewing the marking of meaning on an instructional page. A case study invokes these approaches to describe the visual markers students employ as they write descriptive and instructional text. Although neither group described marked their texts thoroughly, beginning technical writing majors enrolled in a writing class used fewer illustrations and visual markers than technical majors used. The difference in beginning students' performance may be due to prior reading patterns, since the difference is more pronounced in the descriptions than in the instructions. Thus, the paper proposes a longitudinal approach to sensitizing writing majors to visual cues.
April 1990
-
Abstract
The results of a 1987 survey of seventy Canadian four-year colleges and universities indicate that approximately half of the thirty-five responding institutions offer some form of technical writing. While courses are well-received by students and have stable or growing enrollments, faculty attitudes toward professional writing courses are mixed, varying from enthusiastic to disapproving. The other half of the responding institutions do not offer professional writing courses and have no plans to do so. Faculties at these institutions are generally against establishing such courses because they do not see technical writing as a legitimate subject.
-
Abstract
The author reviews recent articles from the technical writing literature focusing on the controversy surrounding the appropriateness of readability formulas for technical writing, an issue of immediate concern for many writers and editors. While some authorities recommend readability formulas—if the writer recognizes the formulas as a tool limited by the variables manipulated—overwhelming argument from other experts suggests that the formulas should be ignored because they can mislead writers by lulling them into a false sense of security or into writing stilted prose to fit the formula. The author suggests that further research should be conducted to study empirically how readability as a concept might be used to aid the technical writer since readability formulas are shaping computerized editing programs.
January 1990
-
Abstract
Jay Reid Gould has had a formative influence on the development of technical and business communication in the twentieth century. In a career as student, teacher, consultant, and author and editor, including service as founding editor of the Journal of Technical Writing and Communication, Jay has helped bridge the gap between technical subject matter and the human concern of communicating this subject matter. Thus he has helped synthesize the sciences and the humanities.
-
Abstract
This bibliography classifies the entire life (1971–1989) of The Journal of Technical Writing and Communication in terms of the following categories: The Profession, Education and Pedagogy, Preparation and Presentation of Technical Information, Research and Theory in Technical Communication, and Application of Technology to Technical Communication. The early bibliographies on which this material draws are the annotated bibliographies compiled by Karen A. Edlefsen (1971–1977), Richard Navarro (1978–1980), and Paul Reese (1981–1984), which were included in the 9:1, 12:1, and 15:4 issues of this journal, respectively. In addition to the materials cited above, this bibliography also includes articles from 1985 to 1989.
October 1989
-
Abstract
As user advocate, usability tester, screen designer, and online documentation specialist, the technical communicator is now playing a role in all phases of product development, from initial design to final support. How has this expanded role come about? What kinds of decisions is the technical communicator responsible for? How must the technical communicator interact with other team members, especially in the exciting, interdisciplinary area of “external design”? This article examines the rapidly growing role for technical communicators in the computer industry as members of the external design team.
July 1989
-
Abstract
Because of the recent emphasis on rhetorical context in business and technical writing (BTW) instruction, the problem-solving case has become a staple in BTW classrooms. However, a number of critics have voiced concerns about the use of the rhetorical case. These concerns recall an ancient debate among Roman rhetoricians over an early case-study method called declamation. For contemporary theorists, the debate over case study revolves around its value as a stimulant to problem-solving skills, its ability to imitate the realistic circumstances of professional BTW, and its emphasis on persona and audience along with its deemphasis of the teacher. A full spectrum of arguments on these and other issues in the case-study debate indicates that the discipline is entering a new phase in its deliberations over the role of problem-solving and pragmatics in the BTW classroom.
-
Abstract
This annotated bibliography identifies and summarizes sixteen current articles portraying the technical writer. Despite the abundance of literature on the subject of technical communication, there is scant literature that describes and humanizes the technical writers—the skills they value, products they produce, roles they play, or industries they serve. The sixteen articles listed here, all published since 1980, paint a picture which may be of use to practitioners, students, educators, authors, and researchers.
April 1989
-
Readers' Comprehension Responses in Informative Discourse: Toward Connecting Reading and Writing in Technical Communication ↗
Abstract
A qualitative study using reading protocols suggests that when readers of informative documents understand conveyed information satisfactorily, they make direct confirmations and positive comprehension evaluations. When readers are uncertain about the accuracy of their understanding, they guess, make assumptions, or render the text's language into their own words. When readers' understanding is impaired, they ask for more clearly established links or relationships in the text, or they pinpoint some ambiguity or lack of resolution. When readers' understanding is unsatisfactory but not impaired, they request additional information. In addition, readers make evaluative suggestions that introduce, focus, emphasize, or reiterate their other comprehension-related responses. The response patterns isolated in this qualitative study indicate the need for specific quantitative research and suggest some directions for developing reader-based heuristics for informative writing.
-
Computer-Based Writing and Communication: Some Implications for Technical Communication Activities ↗
Abstract
Most research on writing has focussed on the work of single authors working by hand on prose texts. However, much professional work is collaborative, computer-based, not exclusively prose, and not well studied. Some preliminary research suggests that the use of computers will affect the cognitive activities of individual authors in several domains of immediate relevance to composition and technical communication practitioners: planning activities, editing activities, the writing of novice computer users or poor typists, and writing for electronic mail and other electronic communication. Research reported here suggests that the rapidly increasing capability of computer-based writing systems will force communication researchers to 1) broaden their basic conception of and methods of studying “author” to include authoring teams, 2) broaden the type of material studied from that which is purely or largely textual to that which much more frequently includes other types of information, and 3) track changes in “genre conventions” resulting from the increased capabilities of computer-based systems—in short, to assess the impacts of the medium on the message.
January 1989
-
What Computer Experience to Expect of Technical Writing Students Entering a Computer Classroom: The Case of Purdue Students ↗
Abstract
Computers in technical writing classes are growing in popularity because professionals increasingly use computers for writing reports and because the computer can aid in producing more visually sophisticated documents. Yet, we do not know what computer experience students bring with them to the computer classroom, a lack of knowledge that makes the task of integrating the computers into the classroom more cumbersome. This article presents the results of a survey of Purdue University students' knowledge of, use of, and attitudes toward computers as they enter the technical writing class. It contrasts the technical students with upper division humanities students and draws conclusions about the documentation requirements and the appropriate computer use goals for the Purdue students surveyed. Finally, suggestions are made about how to use a survey of this type.
-
Abstract
Technical writing students often misuse models given them for their writing assignments because they fail to distinguish between model and example and between different kinds of models. The results of this misuse are texts that contain inappropriate material and are unfit for their intended audiences. The approach to writing taken by these students is too narrow and rigid. This article details the problem and defines the models used in writing as partially abstract, analogous representations of social codifications of linguistic experience. Since models are social artifacts shared by both writers and readers, a clearer understanding of them should help writers produce texts appropriate for their audiences while giving the writers greater rhetorical flexibility.