Journal of Technical Writing and Communication

644 articles
Year: Topic: Clear
Export:
technical communication ×

January 1989

  1. The Discourse Community in Scientific and Technical Communication: Institutional and Social Views
    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.

    doi:10.2190/h6fn-3mkt-qab2-tan6
  2. Amplification in Technical Manuals: Theory and Practice
    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.

    doi:10.2190/aql3-wg5b-7gwa-k59b

October 1988

  1. Ghost-Writing in Professional Communications
    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.

    doi:10.2190/ruph-kww6-4ruu-1wqf
  2. Technical Writing's Roots in Computer Science: The Evolution from Technician to Technical Writer
    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.

    doi:10.2190/l65t-6lj1-pvkr-t6nl
  3. Research Commentary: Technical Writers as Part-Time Teachers in Two-Year Colleges
    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.

    doi:10.2190/qg36-hwlt-fbav-xy65
  4. 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.

    doi:10.2190/cr5w-cqut-0t7f-keu9

July 1988

  1. 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.

    doi:10.2190/19lq-862p-pant-9t3v
  2. Linguistics, Technical Writing, and Generalized Phrase Structure Grammar
    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.

    doi:10.2190/wtlt-qky6-lw4v-w2bd
  3. Literary vs. Technical Writing: Substitutes vs. Standards for Reality
    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.

    doi:10.2190/uakn-cmqf-4dfd-7vx9
  4. Commentary: A New Role for Technical Communication
    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.

    doi:10.2190/44p5-1p1f-0agd-83a3

April 1988

  1. Cognitive Processing, Text Linguistics and Documentation Writing
    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.

    doi:10.2190/20jv-5n1e-6lnr-443u
  2. Practices in Technical Writing in Agriculture and Engineering Industries, Firms, and Agencies
    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.

    doi:10.2190/v852-1m21-m5lm-h672
  3. Toward Competent Writing in the Workplace
    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.

    doi:10.2190/gjdl-t8y0-wh12-fwuw

January 1988

  1. Understanding Criteria Development: A Rationale and Method for Instruction
    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.

    doi:10.2190/90hp-51eg-6e08-q7d5
  2. Poetry at Work: Historical Examples of Technical Communication in Verse
    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.

    doi:10.2190/cmlh-maq8-3jyj-leag
  3. Paideia to Pedantry: The Dissolving Relationship of the Humanities and Society
    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.

    doi:10.2190/c130-hnr7-q92d-76jv

October 1987

  1. Rewriting the Engineering Curriculum: Professionalism and Professional Communication
    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.

    doi:10.2190/vvf3-8a8w-nukh-v0d2
  2. Designing Field Research in Technical Communication: Usability Testing for In-House User Documentation
    Abstract

    A current assumption is that “one best system” can be devised to develop and test user documentation. In-house documentation, however, demands approaches that do not fit into a generic system. Specifically, an in-house manual needs a special type of usability testing, one that measures if and how a manual is used to meet the goals of its organization. Along with quality testing, in-house writers must also run studies on how their manuals actually function in the workplace. This article describes a three-pronged design for actual use testing: user logs; observations; and surveys. In my case study, this testing revealed that users did not use their manuals for reasons other than quality — for instance, reliance on social interactions for acquiring information. My findings show that writing an effective manual requires more than composing skills; it demands writers' involvement in the organizational dynamics that motivate workers to use or not use their manuals.

    doi:10.2190/3g4g-c1n7-75yk-7a6n
  3. Making Technical Communication a Real-World Exercise: A Report of Classroom and Industry-Based Research
    Abstract

    Traditionally, technical communication courses have focused on the written transmission of information. Recent research, however, indicates that oral presentation and interpersonal exchange are as important as writing to on-the-job communication. This article reviews a research project conducted by the authors and students from their technical communication classes that offers important new insights into the rapidly changing environment of technical communication. Based on these insights, it also suggests some new strategies for teaching technical communication — strategies that place an equal emphasis on writing, oral presentation, and interpersonal communication.

    doi:10.2190/ml02-r845-240g-2tlk
  4. From Prose Paladin to Peer Editor: Teaching Engineers (and Others) to Write and Communicate
    Abstract

    Many engineers and other technical/managerial professionals continually generate writer-centered memos, letters, and brief reports. Because such documents often contain needless repetition, excessive detail, and chronology-based information, an approach for encouraging writers to produce clear, well organized, rhetorically sound prose was developed. Technical writing teachers and communication trainers must 1) make these prose “paladins” aware of the essential ingredients for generating reader-centered prose, 2) familiarize these writers with the major steps involved in the writing process, and 3) operationalize the process through face-to-face writer-editor collaboration — involving peer editorial review. Only through frequent drafting and rewriting and the regular sharing of peer editorial response (oral and written) will clear, rhetorically effective prose accrue value. And only then will technical/managerial writers routinely generate reader-centered documents that communicate.

    doi:10.2190/dk4n-qr9q-d43p-rlf1
  5. Designing Ethnographic Research in Technical Communication: Case Study Theory into Application
    Abstract

    Field study, using an ethnographic approach, offers a potentially powerful methodology for the technical communication researcher, a methodology that provides a useful balance to the strengths and weaknesses of experiments and surveys. Technical communication studies, however, exhibit not only the typical constraints of field research but several additional constraints inherent to research conducted on-the-job in business, industry, and government, which deserve consideration when designing research.

    doi:10.2190/dkb7-mh03-n50a-36vj
  6. Writing Research in the Technical Writing Classroom: The Blind Leading the Double-Blind
    Abstract

    A review of recent research in the field of technical writing and communication indicated that although the methodologies employed were sound, they were not fully articulated. An attempt to use a double-blind research design in the writing classroom by dividing the students into competing teams that reviewed each other's work led to some interesting reactions by the students as well as to some the need to introduce more open-ended assignments in our classrooms. Asking our students to come up with competing solutions to the same problem and requiring them to design means of testing their effectiveness can develop their abilities in critical thinking and group dynamics. At the same time this approach will allow teachers to pursue their own research on various problems in technical communication. The result is a unit which has pedagogical effectiveness and suggests new directions for writing research.

    doi:10.2190/95ur-fmne-7xpg-3g6y

April 1987

  1. What Homer can Teach Technical Writers: The Mnemonic Value of Poetic Devices
    Abstract

    One of the primary purposes of technical writing is to create memorable texts, especially when they involve large amounts of interrelated information or complicated step-by-step procedures. Epic poetry traditionally employs poetic devices which aided the poet in recalling as many as 27,000 lines of verse. These devices include not only familiar features such as rhyme and meter, but higher-order patterns of organization called formulae and themes. Recent research shows that these features also enable readers to recall the material. This article explores how these poetic forms work to enhance memory, explores some contemporary research in cognition which has confirmed their mnemonic value, and suggests ways that technical writers may apply them in their work.

    doi:10.2190/nwwr-24vg-1vwe-elac
  2. Using the Entire Manual: A Proposal for the Integrated Presentation of Technical Writing Information
    Abstract

    Instructors in the field of technical writing must incorporate an ever increasing amount of information into their courses. They can save time and stretch the teaching potential of individual assignments by devising writing situations that combine different audiences and purposes. Such situations force students to perceive the writing activity as an integrated whole and make them evaluate different ways to present the same information. The lessons suggested in this article demonstrate the interrelationships between report types and rhetorical approaches, and they allow oral activities to arise naturally. The lessons do not interfere with the philosophical choices that an instructor has made about the proper approach to teaching report writing.

    doi:10.2190/j15f-7m0t-68br-gkrv

January 1987

  1. Profile of Technical Writers in San Diego County: Results of a Pilot Study
    Abstract

    In spite of the recent proliferation of technical writing programs, textbooks, and professional associations, quantitative information on the people and work involved in technical writing is scant. This article reports the responses of 122 technical writers in the San Diego area to a questionnaire asking them about the tasks they perform, documents they produce, skills they consider significant, audiences they write to, working conditions, types of companies they work for, and education and training. The pilot survey also identified other demographic information such as salary and length of service as technical writers and in their present position.

    doi:10.2190/2ymh-y0w6-4kwq-quw5
  2. Breaking Communication and Linguistic Barriers: Designing a Course of Technical Writing in Hebrew
    Abstract

    Scientists and engineers have to present technical information effectively. But when they do it, they face language difficulties which are beyond formal grammar as taught at school. To overcome this problem, we designed a systematic course for technical writing aimed at breaking such language barriers by planned channeling of the scientific message. The course was designed to improve the communication skills of scientists and engineers. In keeping with this goal effective writing criteria were defined and formal presentation conventions were described. Because Hebrew is the common language in Israel, problems of Hebrew structures were presented. The massive infiltration of vocabulary and syntactic elements from foreign languages into scientists' Hebrew style were addressed. An evaluation apparatus was also applied and future prospects of the course were discussed.

    doi:10.2190/6dpd-0abc-yw76-bfl3
  3. Integrating Professional Ethics into the Technical Writing Course
    Abstract

    As communication teachers attempting to bridge the gap between school and industry, we need to give students a true understanding of what it means to be a professional. We may be spending too much time trying to get them to write and speak like professionals without also imbuing them with sufficient understanding of their responsibilities to behave as professionals. Students need to be practiced in the communication and decision-making situations they will encounter in their workplaces. These decisions involve ethical reasoning as well as technical problem solving. Teaching students to appreciate the consequences of their recommendations, through the use of fault-trees and cost/benefit analyses in realistic simulations, effectively bridges the gap between the classroom and boardroom. A sample situation is explained and analyzed for its use in any technical communications class.

    doi:10.2190/3a8m-6jvv-yukf-pnue
  4. Science, Late Nineteenth-Century Rhetoric, and the Beginnings of Technical Writing Instruction in America
    Abstract

    Although engineering departments were dissatisfied with early twentieth-century technical writing teaching methods, those methods were not simply a result of “anti-science” attitudes. In fact, late nineteenth- and early twentieth-century composition teachers tried to accommodate the influx of applied science students by teaching correctness and clarity of style and stressing the expository modes of writing. Emphasis on “clarity” was a legacy of rhetoricians like Hugh Blair of the eighteenth century. Emphasis on expository modes was a legacy of the nineteenth-century rhetoricians' interest in the inductive methodology of “pure” science, a method which implied invention by “observation” and made conclusions “self-evident”: argument was unnecessary since observations and methods only need to be explained to “convince.” Applied science departments were, in reality, dissatisfied with teaching methods based on “pure” rather than “applied” science methodology.

    doi:10.2190/g13y-6h22-1rb0-9051
  5. Schema Theory and Technical Communication
    doi:10.2190/na8w-ne5p-8422-0hjq
  6. Technical Writing Kits: Their Origins, Functions and Context
    doi:10.2190/98wu-2k2u-pb50-3e5c

October 1986

  1. Rhetoric and Relevance in Technical Writing
    Abstract

    As a concept of rhetoric in technical writing, relevance involves an awareness of time. The report deals with the past; the manual, with the present; the proposal, with the future. To be considered relevant, however, all the modes of technical writing must relate to the present reality of the audience. Writers must recognize this need not only as it influences grammar and style but also as it affects larger concerns of organization and tone. Realizing that the temporal classification of modem reports, manuals, and proposals correlates with Aristotle's designation of forensic, epideictic, and deliberative discourse, technical writers can discover a body of rhetorical theory on which to base choices about selection, arrangement, and presentation of subject matter.

    doi:10.2190/cjue-damk-wy8g-j7e4

July 1986

  1. Assignments with the Computer
    Abstract

    The current job market favors young technical writers who are skilled in the way of the computer both as a subject of writing and as a production tool. In the technical writing classroom students can be exposed to this important technology through assignments that include computerized instruction, word processing, text analysis, artificial intelligence, and communications.

    doi:10.2190/lh1k-nm7u-u4up-4tlq
  2. Selecting Metaphoric Terminology for the Computer Industry
    Abstract

    Well-selected metaphoric terminology can reduce the fear and ignorance that often dishearten first-time computer users and can help them grasp new concepts and procedures. Many people are amused by terms such as bit, byte, and mouse and are enlightened by terms such as menu and wild card. Some users of computers, however, are offended by the metaphoric terminology that is commonly used in writing about computers and computing. They bridle at words like memory and intelligence applied to computing machinery. They are annoyed by casual uses of interface and parameter or puzzled by words like spool, boot, and argument. With the concept of usability as their guiding principle, writers in the computer industry can assess the appropriateness of metaphoric terminology by applying seven criteria: 1) Is a metaphoric term needed? 2) Is the old word familiar? 3) Is the metaphoric relation close? 4) Is the usage of the word consistent? 5) Is the metaphoric word brief? 6) Is the metaphoric usage acceptable? 7) Is the metaphoric word memorable?

    doi:10.2190/xaj3-8thn-7qgm-93u5

January 1986

  1. Teaching Technical Writing: Coping with Students' Misconceptions and Evaluation Anxieties
    doi:10.2190/8p7u-wfuy-yvj4-1f2b
  2. Bimodal Consciousness: Psychological States and Writer's Block in the Technical Writing Classroom
    Abstract

    Despite the fact that technical writers try to maintain an objective outlook, they cannot ignore the psychological states of consciousness that influence their writing. Arthur J. Deikman's theory of bimodal consciousness outlines two psychological states: active and emotive (or receptive). Writers must maintain a balance between the receptive state and the active, striving state to prevent writer's block and to enhance creativity, just as scientists balance mathematical (i.e., lexical or verbal) thinking with physics-related thinking. This article describes Deikman's model and shows its application in the technical writing classroom.

    doi:10.2190/8anf-mf0y-neet-d9p9
  3. Where Techne Meets Poesis: Some Semiotic Considerations in the Rhetoric of Technical Discourse
    Abstract

    Stylistic analysis of scientific and technical prose reveals that technical and non-technical expository prose share a number of common characteristics; consequently, common assumptions about a clear stylistic separation between scientific and literary writing are faulty. Technical prose, moreover, possesses a number of rhetorical features which further increase its likeness to literary writing. Both style and rhetoric of technical writing thus point toward non-referential functions in scientific discourse, including the operation of significant cultural codes.

    doi:10.2190/8fhy-87fe-vnhm-pp7c
  4. A History of Specifications: Technical Writing in Perspective
    doi:10.2190/p1xt-9t63-g45h-g607
  5. Doctoral Dissertations in Technical Writing: An Annotated Bibliography
    Abstract

    This bibliography of thirty dissertations summarizes doctoral research in technical writing since 1975. It is intended as the first step in an on-going abstracting service to be performed by the ERIC system. The dissertations range widely, from theoretical pronouncements to classroom how-to's. The collection provides an overview of the kinds of research being done and the institutions sponsoring it.

    doi:10.2190/re95-lfb5-d2jb-y9q3
  6. A Grammatical Update of Pronoun Reference
    Abstract

    Most technical writing texts contain grammar reviews, but few supply more than prescriptive rules to correct persistent examples of unclear writing. To provide a more progressive approach to grammatical analysis, this article applies the non-prescriptive constructs of modern grammar to the recurrent problem of faulty pronoun reference. Grammatical problems often arise because pronouns serve both as form-class and as structure-class words, because they often must agree in case, person, gender, and number with antecedents, and because the pronoun it is often misunderstood as an expletiv. The author suggests that small, problem-oriented doses of modern grammar may help students and professionals alike to better understand the intricacies of textual English.

    doi:10.2190/29fn-kpdq-5jbd-2gcg
  7. Doing without the Generic He/Man in Technical Communication
    Abstract

    Recent psycholinguistic research has challenged the view that English speakers interpret the male pronouns and the generic man as words that refer to both males and females. The suggested ambiguity of these terms is of concern to technical communicators because it can affect the accuracy of their messages. Since guidelines for avoiding sex ambiguity in language are not generally available in technical writing or speech manuals, this article offers simple devices for eliminating the generic use of male pronouns and man. It also provides alternate terms for common sex-biased expressions.

    doi:10.2190/q9u1-7j44-lf6h-0plm
  8. Evaluating Technical Communication Faculty: Some Empirically-Based Criteria and Guidelines
    Abstract

    To evaluate Technical Communication faculty requires understanding of the distinctive nature of the research, teaching, and service performed by faculty in the field. This article documents the work situations and accomplishments of a cadre of twenty-four accomplished faculty members in Technical Communication. The study group, identified by a prior survey of 275 people in technical writing, composition, and rhetoric, provides an empirical basis for defining the kinds and quantities of work that currently can be expected in the field. The article thus helps to provide empirically-based guidelines and criteria for evaluation. Included also is a discussion of other relevant research on faculty evaluation.

    doi:10.2190/p7yy-br2f-g4c0-mnfy
  9. Readability beyond the Sentence: Global Coherence and Ease of Comprehension
    Abstract

    This article interprets research in linguistics and psychology in order to revise and enlarge existing definitions of readability. It suggests instructional methods for teaching students to compose more coherent—and, hence, more readable—technical writing. For a text to be readable, it must be coherent. However, like readability, coherence is variable, depending on the writer and the reader as well as the text itself. The reader is able to understand a message by relying on his shared knowledge with the writer. A starting place for comprehension, cultural and professional knowledge and linguistic knowledge allow readers to set up expectations about a text and to read efficiently. Because accommodating shared knowledge is vital to readable writing, we should teach students how to assess typical audiences and compose in forms routinely used for technical documents. With practice in audience analysis, students learn to accommodate a reader's professional and cultural knowledge. With practice in traditional organizational patterns, stylistic imitation of readable writing, they learn to accommodate common expectations about language and form.

    doi:10.2190/6j1f-datg-1275-jtfk
  10. Co-Associative Lexical Cohesion in Promotional Literature
    Abstract

    Extracts from technical advertising and new-product announcements are used as the basis for analysis of the structures and linguistic signaling of many forms of comparison. Based initially on descriptive texts, the analysis also explains problem-solving texts with and without comparison; and comparative texts are seen to include implicit differences or overt comparison as “knocking” copy. Comparative cohesion by co-hyponyms is shown to be the central feature of co-associative cohesion between separate features of competing products, and clause-relating matching relations are explained in these terms. The concept of improvement is discussed in terms of problem-solving, difference and the matching relations of comparative denial. Final notes are provided regarding the significance of this work to the developing paradigm of technical writing.

    doi:10.2190/b2t3-9p7j-td84-7x7d
  11. Guest Editorial: Writing in the Computer Industry
    Abstract

    Writing in the computer industry most likely provides the greatest challenges for technical communicators. The technology changes rapidly, and there are few established models of how communication products should be written. There are even fewer established models of how communication departments should be run. This article looks at the frustrations, challenges, and rewards of writing in such an environment.

    doi:10.2190/4awk-aglr-6jp3-5yn0
  12. The Westley-MacLean Model Revisited: A Technical Communication Perspective
    Abstract

    Many scholars call for systematic empirical research in technical writing. This article reviews the Westley-MacLean communication model and provides an example of the model within a technical communication context. The author suggests use of the Westley-MacLean model as a means to conceptualize the technical communication process, and illustrates how the model can be used as a technical writing paradigm.

    doi:10.2190/qdpe-9wcu-9u2k-3cng
  13. The Essay and the Report: Expository Poles in Technical Writing
    Abstract

    Les techniques de redaction technique oscillent entre la forme de l'essai (ou les faits sont subordonnes aux idees developpees) et celle du rapport (ou les faits predominent). Elles s'apparentent a la fois aux techniques de redaction utilisees en sciences humaines et a celles pronees par le journalisme

    doi:10.2190/ma0u-8ex6-ugy0-ll9g

October 1985

  1. Some Stylistic Features of Business and Technical Writing: The Functions of Passive Voice, Nominalization, and Agency
    Abstract

    By studying a selection of business and technical texts, one can determine the functions of and the interactions between passive voice, nominalizations, and expressions of agency. One discovers that the distinction between dynamic and stative uses of verbs is crucial for understanding the various functions of passive sentences and nominalizations in business and technical writing. Then the functions of passive sentences and nominalizations are enumerated and illustrated with sentences from business and technical texts before discussing the various devices for expressing agency in passive and nominalized sentences. Only by understanding the various functions of these sentence types can instructors of business and technical writing offer specific and practical advice.

    doi:10.2190/gay1-tc40-wy5r-5t35
  2. Newspeak, 1984, and Technical Writing
    Abstract

    Although George Orwell's “Politics and the English Language” offers good advice to writers, the technical writer's situation and use of language are more effectively discussed in 1984 and its Appendix, “The Principles of Newspeak.” The technical writer must make use of some Newspeak principles, such as limiting vocabulary and narrowing the definition of words; conversely, the writer must try to keep his expression of a corporate point of view and his limitations on wording from finally serving to limit the range of thought itself. Orwell considers these points much more important than “good prose style.”

    doi:10.2190/dgqx-dbu8-kq2k-qakw
  3. The Concept of Consistency in Writing and Editing
    Abstract

    Consistency is the orderly treatment of a set of linked elements, and it is a necessary characteristic of polished, highly readable prose. Consistency is either “uniform” or “harmonious,” depending on whether a set of linked elements is indivisible or divisible into subsets. From the perspective of text characteristics, we can speak of semantic, syntactic, stylistic, spatial, and mechanical consistency. To deal successfully with consistency problems, technical communicators should establish patterns that are logical, evident, functional, resource efficient, and stable. Because of its importance, the concept of consistency should be more fully recognized. Indeed, consistency should be a component of any comprehensive rhetoric of technical communication.

    doi:10.2190/t6em-utt0-el6j-59n9
  4. The Case against Computerized Analysis of Student Writings
    Abstract

    Proponents of computerized text-analysis (CTA) systems like Bell Laboratories' Writer's Workbench contend that the computer's analysis of a text's surface features can help students become better writers and editors. Several colleges and universities have already integrated the new technology into their writing programs, and others will consider doing so in the future. Teachers of technical writing, however, ought to investigate carefully the capabilities and limitations of CTA before applying it to the technical writing classroom. Not even the most sophisticated of today's computers can detect the basic grammar and punctuation errors that bedevil student writers. Moreover, the computer's evaluation of a text's readability and style is untrustworthy and lacks a sound theoretical and pedagogical foundation; indeed, the machine's quantitative-based analysis of writing style might do some students more harm than good. Finally, there is no empirical evidence that CTA helps students become better writers.

    doi:10.2190/345x-fp6d-58j1-l91m