Journal of Technical Writing and Communication
1534 articlesJanuary 1990
-
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
-
Small Farmers' Habits of Reading Agricultural Extension Publications: The Case of Moshav Farmers in Israel ↗
Abstract
With the personnel cutback in agricultural extension services at a time when farmers need to receive more agro-technical information than ever, the need for efficient written communication channels between extension and farmers grows. This is especially true for small farmers, like those living in Moshavim, in Israel. A representative sample of 171 farmers were interviewed. They had quite good reading habits and fewer reading problems than could be expected. Farmers also made good use of the extension publications which they received. The main problems encountered were a weak distribution system and the necessity for authors of extension pamphlets and brochures to consider more the special needs of small farmers. The findings in this study reinforce earlier data from other countries on the potential (and actual) value of written communication as an agricultural extension tool.
-
Abstract
In their searches for examples of rhetorical strategies, students of modern rhetoric frequently overlook writers from the past. In his huge six-book work on the “Art of Falconry” written about 1247–1249, Frederick II, Holy Roman Emperor, a remarkably versatile ruler, an early renaissance man, an empirical researcher, provided numerous excellent examples of rhetorical practices from which students and practicing writers well could learn. This article offers extended examples of definition, contrast, partition, causal analysis, classification, and description, to name but a few.
-
Abstract
This study investigated the role of signaling in helping good readers comprehend expository text. As the existing literature on signaling, reviewed in the last issue of this Journal, pointed to deficiencies in previous studies' methodologies, one goal of this study was to refine prose research methods. Two passages were designed in one of eight signaled versions each. The design was constructed to assess the individual and combined effects of headings, previews, and logical connectives. The study also assessed the effect of passage length, familiarity, and difficulty. The results showed that signals do improve a reader's comprehension, particularly comprehension two weeks after the reading of a passage and comprehension of superordinate and superordinate inferential information. This study supports the hypothesis that signals can influence retention of text-based information, particularly with long, unfamiliar, or difficult passages.
-
Abstract
A study of forty current business/technical/professional writing textbooks suggests that little disciplinary agreement exists about what proposals are and how they differ from some kinds of reports; how the various types of proposals should be classified; and what structural features characterize the genre. Though many texts blur the distinction between proposals and internal recommendation reports, the two are never the same. The textbooks present a bewildering array of classification systems, often failing to distinguish between situation and function. A function-based system could divide all proposals into two categories-analytic (research proposals, R&D proposals, and consulting proposals) and service/product, with bids representing a special case. The lack of disciplinary agreement also makes it difficult for textbook users to internalize a generic structure that will serve for all proposal-writing tasks. Such a structure would include the following: situation, objectives, methods, qualifications, costs, and benefits. The major advantages of such a generic structure are its slots, which make it like a schema; its event sequence, which makes it like a script; and its ability to help writers and teachers understand the relationship among the macropropositions that exist explicitly or implicitly in all proposals.
-
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
This article discusses the impact of possible sex-based differences in communication styles on the technical writer's job. Linguistic research proposes a male and female style of communication. While it is helpful to acknowledge possible differences in communication styles, technical writers must be concerned with the moral and legal implications of sex stereotyping. To explore these issues, the article discusses what it is technical writers do, and who they interact with on a daily basis. It then reviews linguistic research, and linguistic folklore. Finally, the article determines that technical writers can choose to use both male and female traits to acknowledge multiple audiences, and improve the quality of their documents.
-
Abstract
Recent studies indicate that scientific research is part of prewriting in the scientific writing process. This article argues that since invention in scientific research is discovery of the unknown of the scientific community and invention in writing is discovery of ideas within existing knowledge, scientific research cannot be part of prewriting in the scientific writing process. Researchers should be aware that inventional heuristics introduced in freshman composition courses, which serve to discover ideas within existing knowledge, are not always applicable in real-life situations where scientific writing occurs, because the content of discourse is sometimes given in these situations.
-
Abstract
This article reviews previous research on the effects of certain structural cues, called signals, that affect a reader's comprehension of expository prose. It concludes that the inconsistent results of many studies may be due to inadequate methodologies that have failed to control for confounding variables, such as text length and difficulty, reader familiarity with the topic, and timing of comprehension tests. Further, accepted signal types (headings, logical connectives, and previews) have not been sufficiently examined for their individual effects, perhaps creating unidentified disordinal interactions that could preclude the possibility of researchers identifying significant effects. This article concludes with recommendations for more valid research methodology to be used in prose assessment studies. The next issue of this journal will present Part II of this article, which details a new study of signaling effects for readers of expository prose, a study that is based on the refined methodology suggested in this article.
-
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
The purpose of this study was to describe the reports regularly written in mental health hospitals and community mental health centers. Psychiatrists, psychologists, social workers, pastoral counselors, administrators, and records specialists were interviewed. A total of 150 randomly selected samples of five basic mental health records were analyzed. Rhetorical contexts for each were evaluated.
-
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.
-
Abstract
In order to define a problem convincingly, technical writers must first decide what kind of problem they are defining. When both writer and reader begin with the same assumptions about what is important in a definition, problems can be defined easily. However, difficulties occur when writers and readers generally have differing assumptions. This is particularly true about problems involving innovation. Once writers recognize both their own and readers' assumptions about such problems, they can adopt techniques to gain reader concurrence.
-
Abstract
Successful communication between persons within an organization is based on a foundation of mutual trust. Trust is explored through psychological/sociological avenues and finally through its implications for organizations. An atmosphere of trust can eliminate or minimize commonly prevailing communication barriers. Such barriers are classified as context-related (related to the communication environment or setting) and content-related (related to the message itself or the participants). Trust is a critical factor in overcoming communication barriers of both types. Organizational trust can be developed and improved by applying identified strategies. Individual relationships as well as organizational performance benefit from the establishment and maintenance of a trust atmosphere.
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.
-
Abstract
This article argues that an understanding of professional and popular science writers' goals provides a basis for both explaining and evaluating their language use. Rhetoricians fault scientists for unnecessarily stilted language; scientists fault popularists for inaccuracy and sensationalism. Although these charges are sometimes justified, they deflect attention from the obstacles writers face and the ways in which they use language to overcome these obstacles.
-
Abstract
Computer programs for analyzing writing style have grown in number and sophistication over the past decade, and the coming decade will see more and more of them. In order to know the capabilities and limitations of such programs and to decide if any of them are right for you, it is important to understand how they work. In this article, the author draws on his background in computational linguistics to explain how computerized style analyzers accomplish the things that they do.
-
Abstract
In taking “existing practice” in the workplace as their standard, technical and professional writing courses risk leaving students with the impression that whatever is done and is rhetorically effective is right. One way of countering the sophistry of this tendency is to raise questions about the ethics of common but suspect rhetorical practices. This article examines the ethics of one such practice: fostering false inference. Out of H. Paul Grice's analysis of how participants in a conversation correctly interpret what is only implied, it evolves a framework for judging the fostering of false inference. The article presents and discusses a hypothetical case in which a firm's proposal seems intended to mislead, while actually stating nothing that is not literally true.
-
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.
-
Abstract
Findings from a matched study of science writers and their scientist sources seem to portray two basic approaches to the science interview: 1) an asymmetric, carefully controlled interview that produces an overview or “wrap-up” of scientific inquiry within the context of an article generally known as interpretive or explanatory, written for readers of publications such as The New York Times, the Boston Globe, Wall Street Journal, the Chronicle of Higher Education, or Popular Science; and, 2) a symmetric, intense, less controlled interview situation that produces more technical articles of greater depth and breadth, perhaps of one scientist's research or of an important era in a scientific domain, written for readers of publications such as New Yorker, Psychology Today, Science, and Discover. The first type of interview emphasizes two language principles—singularity and parsimony—through use of items on a questionnaire representing tight organization, precise wording, unity, and others; the second type of interview emphasizes two other language principles—redundancy and complexity—through use of items such as clarification, figures of speech, and others. “Understanding” as an item was more highly correlated with use of figures of speech and other items represented in the second type of interview.
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.
-
Abstract
Common technical graphics terms table, graph, chart, and diagram share a parallel logical structure with the four common types of technical graphics that the terms typically refer to. In the system of terminology as in the system of graphics types, four logical categories result from the possible permutations of two features. The abstract semantic features which underlie the meanings of the terms are in this discussion labeled as [UNITS] and [PROPERTIES]; likewise the significant features which distinguish the graphics types are here labeled as “units” and “properties.” These proposed semantic features reflect a fundamental semantic relation common to all meaningful statements, the attribution of a property (a predicate) to an object (a subject). The connection between term-features ([UNITS] and [PROPERTIES]) and type-features (“units” and “properties”) is a variable but systematic sense-reference relation. Consequently the terminology used to refer to the various graphics types varies systematically according to the markedness relationships among the terms. Principled explanations of the best uses for each graphics type follow from the proposed logical relations between them.
-
Abstract
Theoretical studies in scientific and technical communication have begun to explore what they call discourse communities in the sciences and engineering on grounds that these communities provide the norms and practices for communication in these fields. The theoretical literature on which these studies are based develops two views of what a discourse community might be, an institutional and a social view. The first of these views has been the more influential, but both views may and should be brought to the study and the pedagogy of scientific and technical communication.
-
Abstract
Amplification is the set of rhetorical techniques by which a discourse is elaborated and extended to enhance its appeal and information value. Even in the manual, long considered the most laconic of the genres of technical communication, amplification has its place. Drawing on the theory of classical and modern rhetoric, this article shows how amplification tends to increase and improve the coverage, rationale, warnings, behavioral alternatives, examples, previews, reviews, and general emphasis of technical manuals.
October 1988
-
Abstract
Modern professionals commonly write documents to be signed by superiors, but are seldom taught how to do this. If students are successfully to fulfill everyday organizational writing tasks, they must learn to master skills of impersonating viewpoint, style and even personality. To teach such skills, we can adapt the ancient exercise of prosopopoeia or impersonation, either by varying the personas of standard textbook exercises, or by making use of the technical writing case study, or by having students impersonate professionals who were involved in famous (or infamous) current events.
-
Abstract
Current treatments of tone rely on a hit-list approach in which writers are presented with lists of words to avoid and a few do and don't examples. Such treatments, however, do not constitute a theory of why certain linguistic elements create problems in tone. The linguistic concept of presupposition can be used to construct such a theory. Presuppositions are unstated propositions conveyed by the use of certain linguistic expressions called presupposition triggers. These presupposition triggers may convey the writer's beliefs about the truth of a proposition or the writer's value judgments about a proposition. Many problems in tone can be traced to one of two types of conflict between reader and writer: different beliefs about the truth of an implied proposition, and different attitudes toward a proposition whose truth is agreed upon.
-
Abstract
Fundamental requirements for good user documentation have not changed over the years. Manuals must be complete, accurate, clear, readable, and available on time. What has changed are tolerances and standards. Today's users—typically business professionals but even expert technicians and engineers—will no longer accept unreadable and inaccessible publications. The days of documentation with poor organization, limited graphic support, and poor aesthetics have passed. This article analyzes users' opinions and preferences for microcomputer software documentation. The results provide valuable guidance for software authors, designers, and publishers.
-
Plain Style and Scientific Style: The Influence of the Puritan Plain Style Sermon on Early American Science Writers ↗
Abstract
Early American science writers used the Puritan plain style sermon as a readily available prose model. From the sermon they derived an organization divided into doctrine and uses, a format using sectional divisions and heads, the use of simple language, and a concern for the needs of their audiences. Essays on comets by two early American scientists, Samuel Danforth and John Winthrop, illustrate the sermon's influence. The doctrine and uses organization employed in these essays may be seen as analogous, in some senses, to the Results and Discussion organization of the modern research report.
-
Abstract
The history of Technical Writing closely parallels trends in the discipline of Computer Science. The early technical writers in the computer software industry were its own technicians (programmers and analysts), who used a variety of diagramming techniques to document computer systems. As a result of the widespread availability of computers and software which began in the 1970s, professional communicators joined the software industry and reinterpreted these diagramming techniques from technical source documents into user documentation. The impact of this assimilation process has influenced graphic representations in Technical Writing, as well as created the conceptual metaphors of the “user” and the “module” (which are emerging archetypes). In the past, Technical Writing's historical roots have been the result of reactions to Computer Science. However, the increasing presence of online documentation is now creating opportunities for technical writers to shape their own future by joining with computer scientists as influential equals.
-
Abstract
Part-time technical writing teachers who responded to a 1986–87 survey of two-year college technical writing teachers were found to be committed to teaching, well-qualified, experienced, personally involved, and typically employed full time as technical writers or editors. This finding calls into question the unfavorable stereotypical view of part-timers held by individuals and professional organizations. Because of their unique position as full-time practitioners of the skills they teach, part-time technical writing teachers can serve as an important link between teaching technical writing and business/industry.
-
Does Clio Have a Place in Technical Writing? Considering Patents in a History of Technical Communication ↗
Abstract
Technical writers need a historical perspective in order to distinguish between enduring and transitory writing standards, to understand the variety of past styles in building future styles, and to give the profession a better sense of self-identity. To overcome the problems in developing a historical perspective, such as a dearth of artifacts to examine and the peculiarities in rhetorical time and place which undercut attempts to generalize on historical information, the 200 year-old federal collection of patents is offered as a solution. This collection of patents is also very often the only remaining written work of the ordinary mechanic of the nineteenth century, and this collection truly reflects technical not legal, business, or science writing.
-
Abstract
Four of the five issues normally involved in an argument of policy can be persuasively argued on the basis of facts. However, the fourth issue, that of fairness, might better be argued by following the organizational plan of an appellate court decision. The Supreme Court decision in Teminello vs. the United States is offered as an example. The practicality of this plan is illustrated with a student paper.
July 1988
-
Technical Communication, Group Differentiation, and the Decision to Launch the Space Shuttle Challenger ↗
Abstract
One lesson to be learned from the fatal decision to launch Challenger is that effective technical and group communication requires more than the fidelious exchange of information. This article examines testimony gathered by the Presidential Commission on the Challenger Accident and reveals communication failures in four dimensions of group differentiation—clarity, interrelatedness, centrality, and openness. The article illustrates all four dimensions with excerpts from the Commission Hearings and identifies communication problems peculiar to highly technical groups.
-
Abstract
Linguistics has been largely misunderstood in writing pedagogy. After Chomsky's revolution, it was widely touted as a panacea; now it is widely flogged as a pariah. Both attitudes are extreme. It has a number of applications in the writing classroom, and it is particularly ripe for technical writing students, who have more sophistication with formalism than their humanities counterparts. Moreover, although few scholars outside of linguistics are aware of it, Transformational Grammar is virtually obsolete; most grammatical models are organized around principled aversions to the transformation, and even Chomsky has little use for his most famous innovation these days. Among the more recent developments is Generalized Phrase Structure Grammar, a model with distinct formal and pedagogical advantages over Chomsky's early transformational work.
-
Abstract
This article proposes a means of characterizing the difference between technical and literary writing, involving a theory of representation in which these distinct writing types are comparable to distinct types of visual representation. Any difference is only intelligible relative to a background of similarlity, but recent discussions of technical writing emphasize its similarity to literature and ignore significant differences. Distinct types of line drawings replicate the literary/technical contrast in a visual medium. This arises from two factors: 1) the way in which the drawing/text is perceived by the viewer/reader, as a substitute or as a standard; and 2) the predominant type of detail in the drawing/text, iterative or contrastive. Literature is most effective if perceived as a substitute for reality, predominated by iterative detail. Technical writing is most effective if perceived as a standard for evaluating reality, predominated by contrastive detail.
-
Abstract
Increasing public involvement in science and technology suggests a new role for technical communication in which conventional skills of adapting technical content to audience needs may be replaced by skills that facilitate audiences' own information search activities. This article outlines the reasons for the emergence of this new role, and some of the practical implications.
-
Abstract
Editing in a bilingual, bicultural environment involves many of the same problems and frustrations as editing in a monolingual environment; however, the bilingual, bicultural environment often exacerbates these problems. Editing is further complicated by linguistic interference among the author's languages. Finally, culturally conditioned attitudes toward the duties and responsibilities of the editor create areas of potential conflicts between editor and author. If technical participation of non-native English speakers is to increase, as hoped for in such endeavors as President Reagan's policy of the Caribbean Basin Initiative, editors must be sensitive toward those problems in such complicated circumstances.
April 1988
-
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.
-
Abstract
Graduate engineers who took an eight-week course-Effective Oral Presentation of Scientific Information-evaluated their course according to the following aspects of the course: selection of students, size of the class, number of sessions, conferences, and their reactions to the presentations made on closed-circuit television.
-
Abstract
This article describes a study of written communication on-the-job and reports writing practices found in seventeen agricultural and engineering firms and agencies in the authors' immediate geographical region. Information was gathered by questionnaire and on-site interviews. Data confirmed the importance of writing on-the-job. Our findings demonstrate the importance of context and reveal the variations in types and length of documents, rhetorical genres, and strategies. The study proved useful for designing instructional materials and strategies and for expanding our basic understanding of what on-the-job writing entails.
-
Abstract
Focusing on the crucial role of technical editors and communication managers, the article describes technical editing in environmental and energy research at The Oak Ridge National Laboratory (Oak Ridge, Tennessee). The author examines the kinds of documents prepared, the audiences for whom the documents are intended, and the editing process employed by the Technical Publications Department. The author concludes that communication plays a vital role in complex research and technology and that communicators at The Oak Ridge National Laboratory occupy a central place in the efficient operation of this complex, multipurpose research facility.
-
Abstract
Findings from a comparison of undergraduate and on-the-job writers recommend some changes in traditional methods of teaching technical writing in college. Freshmen, sophomores, juniors, and “competent” writers in business and industry were given the same composing task. The writing of the employees showed telling and sometimes unexpected differences in a wide variety of areas, in length, vocabulary, organization, specificity, coherence, sentence formation, and surface error. Implied is increased attention to several general writing skills: compression of meaning, fluency of expression, efficiency in techniques of coherence, expandability of organization and syntax, and rhetorical maneuverability and adaptability.
January 1988
-
Abstract
One of the most neglected topics in Technical Communication textbooks and professional articles is the concept of criteria development. Most approaches to teaching criteria development tend to be prescriptive, overly superficial, and, at times, confusing and misleading. One can develop criteria for evaluating the relative merits of potential solutions to problems only after a thorough problem analysis. Criteria themselves derive from two sources: assumptions drawn from the conditions of the problem itself and external constraints that create additional barriers to problem solutions. This article provides a rationale for emphasizing methods of teaching criteria development and describes a heuristic for identifying relevant criteria. Such an approach also addresses national concerns that we develop teaching methods that allow students to think logically, systematically, and analytically.
-
Abstract
Poetry has imparted technical information to workers for centuries. This article presents both literary examples of poetic technical literature, and traditional examples of rhyme and song which acted functionally to lead and instruct workers in specific tasks. In so doing, it illustrates the usefulness and time-honored acceptance of poetic devices in technical communication.
-
Abstract
The changing relationship of humanist education and society may be traced through historical changes in the relationship of formal education to technical writing. Technical writing with its intrinsic social purposes provides a powerful metaphor for the needs of society, and the resistance of the modern English department to applied writing provides evidence of the growing separation of society and the humanities. From classical philosophies of education through the humanist movement of the Renaissance, education was committed to the development of ideal leadership. Both classical and Renaissance humanists were epistolographers and public orators, meeting the needs of their societies. Modern humanists focus on the individual and the text. While Western culture from ancient Greece to the Renaissance educated citizens to specific service in society, the modern humanities are failing to combine utility with the preservation and creation of knowledge. Teachers should emulate the humanities of the past and teach writing as a social force in technology, politics, and business.
-
Abstract
A review of the current literature suggests that the concept of purpose has not received sufficient theoretical or pedagogical attention. In this article, theoretical depth is provided by a discussion of four components of purpose: purpose as associated with discourse types, purpose from the writer's viewpoint, purpose as it relates to situation, and purpose from the reader's viewpoint. Research is cited, and examples from computer documentation are used to illustrate each component. Cooperation and conflict among components are examined in a sample document, and classroom applications are discussed.
-
Abstract
This article is concerned with reviews, surveys, tests, and other formal procedures used in writing for the computer industry that are designed to provide authors and publications managers with information about the quality and nature of documentation. The literature in this area reveals a number of problems with feedback in hightech writing, including the lack of a consistent definition of feedback processes. The article investigates various types of reviews, theoretical aspects of feedback, and elements of feedback specific to hightech writing. This investigation yields three consistent perspectives on feedback: management, style and rhetoric, and research.
-
Abstract
This study examines three dimensions of paragraph topic sentence use in a corpus of scientific writing made up of research articles in biochemistry, geology, psychology, and sociology: 1. frequency of topic sentence use; 2. variation of topic sentence frequency in five rhetorical divisions; 3. variation of topic sentence types in these rhetorical divisions. Although the scientific writers used topic sentences in 55 percent of their paragraphs, differences existed among rhetorical divisions as to topic sentence frequency: writers used topic sentences quite often in results, results/discussion, and discussion, but quite seldom in methodology. Furthermore, topic sentence types differed across the divisions. In methodology, the topic announcement predominated; in discussion and introduction, the propositional occurred most often; in results and results/discussion, there was a balance of the two types. All these variations are thought to be related to differences in function (reporting facts versus interpreting) and texture (attributive versus logical text) across the rhetorical divisions. These variations may also affect ways of teaching paragraph skills in scientific writing.
October 1987
-
Abstract
Although engineers spend a substantial amount of their time writing or delivering oral presentations, the typical engineering curriculum segregates communications instruction from technical coursework. But out of an increasing sense of responsibility to provide more authentic professional training, engineering educators are developing programs which bring “real-life” contexts into the classroom. As a result, technical communications instruction is changing in significant ways. Writing clinics are tailoring their services to the precise needs of those they serve and expanding the range of professional support they offer. Furthermore, writing across the curriculum has significantly influenced engineering by linking composing and understanding. New communications courses parallel professional classes, and some redesigned engineering courses actually integrate verbal communication with “subject matter” instruction, Since these broad structural renovations are paradigmatic for other professional programs, technical writing teachers can and should facilitate and support such developments.