Journal of Technical Writing and Communication
644 articlesApril 1982
-
Abstract
Translation is a form of technical writing in that both translators and technical writers assess their work by comparing it with a concrete object or process (a technical text with its subject, a translation with its original). Among aspects of language that concern translators and technical writers is that of “sublanguages,” subsets of a language used in special fields of knowledge, having distinct lexical, grammatical, and syntactic features. Sublanguage knowledge plays a vital part in both translation and technical writing. The relations found between the two professions also imply some ways technical writers can improve foreign-language services they receive.
-
Abstract
A brief overview of methods relating language education to psychological theories and models is provided. Strengths and weaknesses of behaviorist and mentalist approaches are surveyed, followed by an outline of a recently developing cognitive-process approach. The approach is then illustrated with an individual case study from the University of Florida writing program, with special consideration of the concerns of technical writing on the topic of automobile repair instructions. It is argued that specific tendencies carry over from speech habits that are partly supportive and partly contrary to success in learning the skills of technical writing. Consequently, appropriate training should be able to alleviate the contrary tendencies, provided we take into account the operations of writing.
-
Abstract
In order to repair defective equipment in the shortest possible time, the repairman needs functional service manuals. These manuals are made by the technical communicator, who gets his “input” from the development engineer. Three different people, with different background and training. This article concentrates upon the relationship between the engineer and the communicator. How can they help each other in order to obtain a useful manual?
January 1982
-
Abstract
Requirements of accuracy in technical writing overwhelm considerations of stylistic grace. Analysis of the resulting technical style, however, often reveals a discrepancy between technical and verbal accuracy. The object of verbal form is an accommodation between grace and accuracy. Several avenues to achieve this accommodation are presented from Martin Buber's I and Thou to psycholinguist theorists such as George Miller and Walter Kintsch. Linguistic theory and literacy analysis can also provide means of reestablishing grace, not as replacement, but in contention with technical accuracy. The aims of technical discourse, like that of all other discourse, should include the gracefulness of one human being speaking to another.
-
Abstract
This annotated bibliography includes all articles published in the Journal of Technical Writing and Communication, 1978–1980. The articles are divided into the following categories: 1) The Profession, 2) Education and Pedagogy, 3) Preparation and Presentation of Technical Information, and 4) Applied Theory in Technical Communication.
-
Abstract
We may discover the basis for a humanistic rhetoric of technical writing by examining managerial theories of human behavior. Complaints about the deficiencies of writers and their work correspond remarkably to complaints about the deficiencies of employees and their work. And both sets of complaints may actually be related to the traditional Theory X of human behavior, held by managers and teachers of writing. An alternative managerial theory proposed by Douglas McGregor, Theory Y, suggests ways to encourage an individual's initiative and to satisfy the organization's goals simultaneously. Since technical writing weds the worlds of writing and working, this managerial theory can provide a sound basis for a rhetorical theory that encourages a writer's initiative and satisfies the goals of writing simultaneously. The letter of application for employment illustrates how Theory Y works.
-
Abstract
Technical writing required of employees in business and industry has been investigated, but the writing demands on graduate students have not been systematically surveyed. To find out what kinds of writing are required of graduate engineering students, twenty-five engineering faculty members from the Engineering College at the University of Florida listed the kinds of writing assigned to graduate classes during the academic year 1979–80. Since the faculty members were asked to rank-order the writing kinds from most frequent to least frequent, the Friedman analysis of variance and the Wilcoxon Signed Ranks test were used to test for differences in the rank ordering. The tests showed that faculty assigned examinations, quantitative problems, and reports most frequently, that they assigned homework and papers (term and publication) less frequently, and that they assigned progress reports and proposals least frequently.
-
Abstract
The author of this article argues that all too often teachers of technical writing spend too much time pressuring their students to write simply and without jargon, and that as a result they often get writing that is bad because it is skeletal and undeveloped writing lacking in continuity and narrative functions. The technical writer is often overjoyed to submit outline-writing because it requires small effort, not realizing that it shifts the burden of interpretation to the reader. The author recommends a number of cures for the skeletal technical paper.
October 1981
-
Abstract
The disciplines of software engineering and technical writing have much in common. Both espouse a structured approach to product development, whether the product is a computer program or a manual describing that program. These disciplinary parallels suggest that technical communicators have more to offer software engineers than our usual writing and editing services. Specifically, this article describes four special services that technical communicators could provide during the first phase of software development, requirements. These services are audience analysis, functional analysis, human factors research, and requirements writing. The goals of these services are to improve the quality of software products and to make the documentation task more efficient.
-
Abstract
At present the ethical concerns for technical communicators are narrowly defined in terms of management issues. Ethical problems cannot be solved by such a simplistic view. Instead we need to explore the ethical nature of the professional fields technical and science writing supports, the ethical positions in closely related fields, and the work that has already been accomplished in the general area of communication ethics. Once we have established such a foundation, we can begin to explore the most basic influences inherent in language uses on ethical concerns.
-
Abstract
Having students read selected portions of Benjamin Franklin's Autobiography provides unique and effective material for supplementing instruction in style and control of tone. Franklin's writing exemplifies the major style characteristics taught in technical writing: active voice, conciseness, common words, concrete language, sentences structured by clauses rather than phrases. The work clearly shows that good “technical” style is not an isolated type of writing, but a powerful means of controlling tone and meaning. Students can be shown that by skillfully using syntax and diction and by carefully selecting content, Franklin shrewdly and effectively achieved his goal in writing the Autobiography — a precisely drawn image of himself for posterity.
-
Abstract
Various style manuals, advice to authors, and textbooks on writing stress that writers should prefer the active voice of the verb and avoid the passive form. The following bibliography brings together references to the passive voice of the verb from linguists, grammarians, and researchers of the use of passive voice verbs; comments from technical writing textbooks; comments from books on language; comments from style manuals; and references from various other sources. The annotations summarize the principal points the article makes about passive voice verbs (abstracts provided by the authors of the articles are marked with an asterisk (*)). Part I covered materials from linguists while Parts II through V list references in technical writing textbooks, style manuals and authors' guides, and various other sources.
July 1981
-
Abstract
This article is placed within the defined area of study of “coherence,” which is seen as one of the three parts of recent work in the “discourse analysis” of contemporary English prose with emphasis on technical writing. One element of the total system of coherence is seen to be the “associated nominal” which, together with repetition, substitution, deletion, synonymy, among others, enables writers to maintain the thread of continuity in a text. Introductory details of associated nominals are given, and some of their purposes and environments of use are described with the use of examples of actual English use. Potential effects of this work on the teaching of technical writing are mentioned, and detailed references and anannotated bibliography assist readers who may wish to read further.
-
Abstract
Various style manuals, advice to authors, and textbooks on writing stress that writers should prefer the active voice of the verb and avoid the passive form. The following bibliography brings together references to the passive voice of the verb from linguists, grammarians, and researchers of the use of passive voice verbs; comments from technical writing textbooks; comments from books on language; comments from style manuals; and references from various other sources. The annotations summarize the principal points the article makes about passive voice verbs (abstracts provided by the authors of the articles are marked with an asterisk (*)). Part I covers materials from linguists while Part II, to be published in the next issue, lists references in technical writing textbooks, a selection of general books on language, style manuals and author's guides, and various other sources.
-
Abstract
Creative and technical writing share definite, but seldom realized, affinities. Like the fiction writer, the engineer and the scientist must realize that writing is a creative process rather than a reflex action if they are to communicate successfully. Often, professional advancement depends on the ability to present and to interpret factual information coherently and effectively. Although technical writing presents factual information and creative writing fictional information, both crafts adhere to the same underlying rhetorical principles in order to create their desired effects. This article examines those shared principles that make technical writing more than a prosaic exercise and allow writers to express themselves meaningfully. The role of imagination in this craft is also explored.
-
Abstract
Moby-Dick is a classic of technical literature as well as a classic of American literature. But for the technical writing teacher, its relevance goes beyond this: Moby-Dick can also be a valuable teaching resource. It provides pertinent examples for teaching students the concepts of audience, purpose, research and sources, use of background experience, and thoroughness in compiling data. It also supplies ample models of technical definitions, descriptions, processes, and theories. Finally, Moby-Dick demonstrates the kind of energetic technical writing that is so needed today.
April 1981
-
Abstract
The first section sketches a broad historical framework in which to understand the emergence of the computer and the profession of technical communication and sets the stage by concluding that the computer is both a part of the technological milieu which needs technical communicators and a tool which communicators can use. Then comes a brief review of computer applications in terms of numerical, nonnumerical, and communication applications and dumb, clever, and intelligent program functions. Then the author argues that advances in computer science will narrow the gap between writing computer programs and documenting them to the point where technical communicators in the software field will be programmers. The final section suggests that computing technology will give technical communicators professional autonomy comparable to that currently enjoyed by doctors and lawyers.
-
Abstract
The debate as to whether heuristics or prescription provides the best approach to teaching technical writing is still largely unresolved. When heuristics are used as process, as problem-solving devices, and when prescription is used as a product-producing device, a useful synthesis of the two approaches occurs. This article presents such a synthesis of heuristics and prescription; it concludes with a short annotated bibliography on heuristics and prescription which can be used by the technical writing teacher and the technical writer.
-
Abstract
In most textbooks on technical writing, understandability of sentences is misleadingly equated with grammatical primitiveness. In actual technical writing, however, writers regularly conform to six basic rules dealing with the uses of base clauses and free modifiers, as well as punctuation. There are ten types of free modifiers, which can be used singly or in parallel or nonparallel sequences. All types are used either to add details to a key idea expressed in a base clause or to make transitions between one sentence or paragraph and another.
-
Abstract
A technical writing course can simulate the work situation and develop in students the uniquely human faculty of imagination. Whole-group effort is needed to sustain the fiction that the course is a job. Special presentation by the instructor of traditional assignments is essential. Such a course prepares students for demands made on the job. More importantly, the course, by emphasizing the act of imagining, enables students to progress from fitting facts into given formats to designing reports for specific communication situations. Because of this emphasis on imagination, the course is a humanities offering as well as a technical complement.
January 1981
-
Abstract
Mail survey research exists which can provide guidelines in the development of two-year college technical communications curriculum. This paper describes what surveys exist; where they have been reported; and what they have found. Close examination reveals that there are areas of research saturation and areas of research deficiency. By developing new types of questions to cover these areas of research deficiency, future researchers will be able to analyze vital new areas of knowledge.
-
Abstract
Since technical writing is changing from a course for the scientific elite to one with a much broader base, the need to diagnose in technical writing classes is growing too. The right diagnostic tools can allow the instructor to set class goals more effectively, structure the course more efficiently, and discover and deal better with student expectations. The diagnostic we have designed, asking students to compose a memo which discusses their projected needs as aspiring technical writers, yields useful information about the stylistic strengths and weaknesses of the students. But more important, the diagnostic provides guidelines for choosing among the flexible units of study at the instructor's disposal, and also reveals student attitudes, preconceptions, and prejudices — data which aid the instructor in laying the proper groundwork in the early phases of the course.
-
Abstract
Effective use of graphics and skills in analyzing information are two topics that need to be covered in depth in the basic technical writing course. Many kinds of computer printouts can be understood by students from various disciplines. From these printouts, problems, like the ones described here, can be developed to teach graphics skills and analysis concomitantly. Using computer printouts to teach these two important topics has four specific advantages: 1. students become familiar with reading and interpreting computer printouts and learn to separate essential from nonessential data in defining a problem; 2. they learn to write analytic or information reports using computer data only; 3. they gain practice in determining what kind of graphic is best for a specific kind of information; and 4. they gain practice in correlating verbal discussion with visual presentation.
-
Abstract
This article emphasizes four syntactic-rhetorical imperatives which make written messages easier to read. 1. Keep subjects and their verbs close together. Since native speakers of English expect verbs to follow subjects closely, any intervening element makes the processing of information difficult. The longer the intervening element, the more difficult the comprehension of the message. 2. Use appropriate prepositions between nouns to explicitly indicate their semantic relationships. Long nominal phrases are hard to understand because these implicit relationships create ambiguity. What compounds the difficulty of the message is that all the nouns in the phrase, except the last one, assume the function normal to adjectives namely, modification. 3. Help readers to segment syntactic units correctly. The obstacles to readability in this area are the omission of commas and of the signals of subordination, and the misplacement of modifiers. 4. Match textual sequence with chronological sequence. If the sequence of the events does not match the sequence of their reporting in a piece of technical writing, that piece of expository prose is bound to communicate poorly.
October 1980
-
Abstract
This paper distinguishes Skill I, the ability to communicate with the lay audience, from Skill II, the ability to communicate with the technically expert audience. It also discusses the origins of the misunderstanding of the role of these two skills in the technical writing classroom and demonstrates how this failure works against an efficient and successful technical writing program. Some suggestions are offered to remedy this situation which, if followed, would not only remedy the existing problem but would form the base for a comprehensive technical communications curriculum.
-
Abstract
Technical communication is not one discipline but three, each addressing its own distinctive set of problems and applying its own particular criteria when deciding which of the alternative solutions it has generated addresses its problems most effectively. Of the three, only the professional discipline is conducting its research satisfactorily; the teaching and theoretical disciplines are not. All three could improve their research activities by posing themselves a wider variety of significant problems, generating a richer array of alternative solutions, and conducting more carefully the activities that enable them to select the alternatives most worthy of continued attention and use.
-
Abstract
Because of doubts about the status of paragraphs after World War II and the influence of readability formulas which emphasize sentence length and word length, technical writing teachers and texts have not been concerned very much with stylistic matters, especially at the paragraph level. However, recent research advances in the fields of linguistics, discourse analysis, cognitive psychology, and readability all redirect our attention to matters beyond the sentence in technical writing. A familiarity with such advances—including an understanding of cohesion elements, the “given-new contract,” and tagmemics—can enable technical writing instructors to improve student writing.
-
Abstract
The present confusion over what technical communication is or ought to be is a temporary condition brought on by challenges like those issued by Paul Anderson, John Brockmann, and Jack Selzer. They have raised important issues which challenge practices and assumptions which many of us in the field have accepted tacitly. However, the weaknesses they have identified in the disciplines of theory and pedagogy do not necessarily indicate the failure of those disciplines to come of age. Thomas Kuhn's concept of “paradigm” suggests that such criticism may actually indicate new growth in already mature disciplines.
-
Abstract
As technical writing programs grow, English departments may alleviate the problems of the unprepared instructor by offering technical writing theory and pedagogy courses. Such courses should combine theory and pedagogy with assignments that are practical and introduce graduate students to the theoretical issues in the field. This article provides a syllabus and the reactions of students who completed such a course.
-
Abstract
Many current teaching practices in undergraduate technical communications are insensitive to students' career needs because they are based on mistaken notions concerning writing and the process of communication. The specific problem areas in current teaching practices include: the lack of emphasis on rewriting and on the cooperative element of technical communication, the overreliance on proscriptive strictures in graphics instruction, and the undue emphasis on large-group oratory in oral communications. Academic teaching methods need to be better informed by the practices and procedures of professional technical communicators in order to correct their mistaken notions and to more effectively meet students' career needs.
-
Abstract
The work of a technical writer must be readable and easy to understand. Indeed, we have methods to teach students how to be readable. But is it reasonable to request creativity in their work? There are differences between the style of a technical writer and of a novelist. But there are also similarities. To be creative in his technical writing, the technical writer must be influenced by the novelist. I advise especially the study and writing of essays and poems.
July 1980
-
Abstract
This is an evaluation of the undergraduate technical communication major in the Department of Rhetoric, University of Minnesota, St. Paul, 1979. Three audiences received the questionnaire: technical communication graduates, potential employers, and members of the Society for Technical Communication. The questionnaire was designed to determine perceptions of technical communication courses, rank-ordering of competency areas, and listing courses that should be required for all technical communication majors. The results are reported and discussed in this article.
-
Abstract
This study examines some assumptions about context clues. Relating research in vocabulary instruction for readers yields a generic system of semantic function categories. These categories are broad enough to include word and nonword clues. Samples from technical writings of different readability levels are analyzed to demonstrate the utility of teaching such a system to technical writers and editors.
-
Abstract
The fact that some ideas seem to be inexpressible directly in language and that the induction-hypothesis sequence in scientific thinking does not completely account for new ideas may be due to the peculiar abilities of the right and left hemispheres of the brain. Study of the mind and philosophers of perception suggest that perception and imagination or fact and intuition are combined in language, which then takes on new meaning through “coherent deformation” and leads to new thinking. This new thinking then can best be replicated in the reader through nondirect means such as metaphors and visual materials.
-
Abstract
Technical writing students need information about writing for the government: one out of every eight technical writers works in some level of government. Those who do not might become involved in writing for the government in some other capacity, such as writing industrial proposals to obtain grants and contracts, or preparing scientific reports or technical manuals to fulfill the requirements of those grants or contracts. Such writing requires a familiarity with government specifications and standards. Some colleges offer courses in government writing. Those schools that cannot might consider incorporating information about government specifications and standards into their basic technical writing course.
-
Abstract
The management of information has become one of the central competencies needed in a technological society. The development of systems for the storage, retrieval, editing, packaging, dessemination, and utilization of scientific and technical information is especially needed. Just as crucial, however, is the necessity to train individuals who can assume information management and “linkage” roles. The scientific and technical communicator is one such individual. This paper attempts to explicate the concept of technical communication competence and demonstrate the potential utility of its operational counterpart in the training of students in scientific and technical communication. The potential benefits of implementing a technical communication competence testing program in scientific and technical communication curricula are explored, both for students and for educators and professionals.
April 1980
-
Abstract
Efficient information flow in technical communication depends upon accurate audience analysis. The presentation of information must be adjusted relative to the knowledge and interests of the writer's audience. Problems arise when the relative differences in audiences are slight, but nonetheless important. Albert Einstein's writing can be used as an example of skillful adaptation of material for audiences with subtle differences. A prime example is his special theory of relativity, which he published in three versions for technical, semitechnical, and nontechnical audiences. Students, teachers, and technical writers can learn much from the way Einstein uses tone, personal address, varying levels of diction, definitions, and concrete examples of each of the three expositions of his special theory of relativity.
-
Abstract
The concept of “rule,” derived from linguistics and anthropology, provides a way of understanding the relationship between context, purpose, and message production and interpretation. “Rules” are shared expectations which structure situations and guide individual action. This paper reviews some of the concepts that have come out of rules theory in communication research and suggests their particular relevance and utility to understanding the problems and situations in technical communication.
-
Abstract
A survey-experiment at the University of Leeds, England, attempted to resolve two questions: (1) Are some grammatical structures more efficient than others in communicating scientific fact? and (2) Do students pursuing different academic disciplines have correspondingly different value systems with regard to technical writing and technical subject matter? The results of the survey, which sampled 300 students, indicated yes to both questions. Particularly ironic was the finding that the third-person passive voice, so commonly the style of twentieth-century technical English, is disadvantageous from a communication standpoint.
-
Abstract
Kinneavy's theory of discourse and Mathes' concept of contextual editing can be effectively applied to teaching classification in technical writing. My procedure, in the nine steps described here, provides students with an understanding of classification as an analytical and generative tool. Its usefulness in analysis is discovered through a structural study of Mumford's “Machines, Utilities, and ‘The Machine‘”; an awareness of Mumford's classificatory structure helps students understand his essay. Students see for themselves, by organizing facts into paragraphs, the generative power of contextual editing applied to classification; the same kind of structuring Mumford uses can be used in their own writing. This generative application simulates the research-to-writing process and dramatically increases the coherence and clarity of much student writing.
-
Abstract
In order to correctly and concisely understand a scientific, technical English article written by Japanese specialists, the readers should understand in what areas of English grammar they are inclined to make mistakes when they write an English version. The most crucial mistakes made are usually certain aspects of English grammar. Learning the key mistakes from a Japanese specialist will also help an English teacher focus more efficiently on profitable areas of teaching.
January 1980
-
Abstract
The motivated sequence is a strategy which, by allowing the writer to organize ideas in a pattern corresponding to the stages inherent in the natural thought processes, can help improve technical communication. It is especially valuable in documents that are an intrinsic part of the decision making procedure, as is the case with the Environmental Impact Statement. This article explains the motivated sequence and, using the Environmental Impact Statement as an example, demonstrates how its use can improve technical communication.
-
Abstract
Audience and definition are the two foundation concepts of technical writing, for all technical writing is, in a broad sense, definition. Reports that classify, partition, analyze, describe, illustrate, compare, and contrast essentially define a concept or problem. Thus, classification, partition, description, illustration, comparison, and contrast represent seven of fifteen devices which can be used to expand definitions. The expanded definition, as a beginning assignment (after audience analysis), can show how these same devices are embedded in the major ways of organizing information for reports, technical descriptions, process analyses, and instructions — topics later introduced in the course. Furthermore, developing content about these specific devices helps students to catalogue mentally information about a subject and to organize and present this information precisely.
-
Abstract
A long-term relationship between a technical writing program and a single non-university organization can have rewards as significant as short-term relationships with several such organizations. Four specific programs of interaction now in effect at Battelle Memorial Institute and Ohio State University provide Battelle personnel ready access to information on the state-of-the-art of rhetorical theory and assure them of a large pool of well trained writers as potential employees. The technical writing faculty gains confidence and a better understanding of the tasks typically performed by technical writers over long periods of time. Description of these particular programs of interaction suggests ways to foster similar programs elsewhere, even in the absence of nearby research foundations.
October 1979
-
Abstract
Dramatic cultural and social changes during the past two decades have strongly influenced the dimensions of the communication process. Contemporary communicators argue that communication adaptation has not kept pace with technological and cultural adaptation. One reason they cite is the continued reliance on traditional theories and methods when new systems and strategies seem more appropriate in our complex society. Communicators of technical and scientific information tend to be conservative and change methods slowly. Some do not accept the concept of process as change. If we are to overcome the adaptation lag, and help individuals learn to control the imbalance created by the communication explosion, we must adjust to the idea of change. We must be more innovative, exhibit more flexibility in our attitudes, and assume responsibility for becoming better informed about interdisciplinary relationships and research in communication.
-
Abstract
Technical materials often do not produce the response desired by their authors. Reasons for the failure of the document are errors in audience analysis and the rapid obsolence of the materials. This article suggests that communication theory, in general, and cybernetics, in specific, may help ameliorate these problems. The knowledge of communication theory and systems analysis could sensitize writers and editors of technical materials to a variety of factors such as the dynamic nature of the communication process and the fact that the process is interactive rather than unidirectional. It is suggested that the application of these theories could increase the effectiveness of technical communication.
-
Abstract
The technical writing course has the potential to be one of the most valuable and relevant classes that a student takes, but before his rhetorical skills can improve he must overcome his reluctance to write. The formal technical report, the most challenging and the most rewarding assignment, offers the technical writing teacher a unique opportunity to bring his course to life and to enrich each class member's learning experience. The author has developed an approach to the major report that allows the student to assume the role of a consultant in his field while simultaneously permitting him to feel independent and creative. The inexperienced technical writer must create a realistic situation in which someone would require the technical information he wishes to convey. Placing the student in the role of a consultant makes him more aware of his audience and its needs. This problem-oriented approach effectively increases the writer's liberty to choose an appropriate topic and his responsibility to present it in a coherent and professional manner.
July 1979
-
Abstract
Liberal arts colleges that elect to introduce technical writing courses or programs into their curriculum face the dilemma of vocationalism vs. liberal education. This paper examines the philosophical differences between the two as well as their practical compatibility or incompatibility, and then argues for the union of technical writing and the liberal arts school while admitting certain reservations. The technical writing course at a liberal arts school should use a wider range of books and periodicals than should a technical school, should stress rhetorical theory and strategy, and should confront the moral issues resulting from technology.
-
Abstract
The achievements of great men like George Washington Carver are often perpetuated by myth; but more often they are simply overshadowed by the stature of the man himself. Such is the case with Carver. Thus, this article seeks to identify Carver's achievements as a technical communicator through a brief analysis of some of the technical bulletins he wrote while directing the Agricultural Experiment Station at Tuskegee Institute.
-
Abstract
The contemporary technical writer, who often must fill the current demand for environmental impact statements and similar environmentally oriented documents, can perhaps benefit from reading the works of some of the classic naturalists such as William Bartram, Henry Walter Bates, and Charles Darwin. These early writers show an ability to present concretely detailed observations of flora and fauna without sacrificing readability and without losing touch with the natural world under observation. The best technical writing today can combine essential efficiency with sensitive treatment of environmental subjects.