Journal of Technical Writing and Communication
607 articlesApril 2007
-
Structuring Job Related Information on the Intranet: An Experimental Comparison of Task vs. an Organization-Based Approach ↗
Abstract
In this article, we present a usability experiment in which participants were asked to make intensive use of information on an intranet in order to execute job-related tasks. Participants had to work with one of two versions of an intranet: one with an organization-based hyperlink structure, and one with a task-based hyperlink structure. Efficiency and effectiveness were measured in terms of execution time and task accuracy, respectively. After the task execution, participants were asked to evaluate the task as well as the intranet. The results show that participants perform more efficiently with the organization-based structure, which is probably due to their familiarity with this structure. A post hoc analysis revealed, however, a learning effect in the task condition, which suggests that once users are acquainted with it, a task structure is at least as efficient.
January 2007
-
Abstract
This historical case study of a non-rule policy document (NPD) adopted by the Indiana Department of Environmental Management describes an emerging genre in environmental discourse. The NPD standardizes environmental public policy for land disposal of foundry sand, a solid waste. The collaborative writing process took six months with industry input, and the NPD was presented to two environmental boards. Two contrasts, in process and format, distinguish NPDs from rules. The NPD is an entirely new kind of writing which includes guidance for implementing statutes. The writing process in the case involves government writers and industry representatives, although it does not include other public input such as public hearings. Instead, the staff of the pollution control agency simply presents the NPD to the appropriate environmental policy boards and arranges for its publication. This article adds to the body of knowledge about technical writing in government, specifically environmental policy and non-academic genres.
-
Expressive/Exploratory Technical Writing (XTW) in Engineering: Shifting the Technical Writing Curriculum ↗
Abstract
While the importance of “expressive writing,” or informal, self-directed writing, has been well established, teachers underutilize it, particularly in technical writing courses. We introduce the term expressive/exploratory technical writing (XTW), which is the use of informal, self-directed writing to problem-solve in technical fields. We describe how engineering students resist writing, despite decades of research showing its importance to their careers, and we suggest that such resistance may be because most students only see writing as an audience-driven performance and thus incompletely understand the link between writing and thinking. The treatment of invention in rhetorical history supports their view. We describe two examples of using XTW in software engineering to plan programming tasks. We conclude by discussing how a systematic use of XTW could shift the technical writing curriculum, imbuing the curriculum with writing and helping students see how to problem-solve using natural language.
October 2006
-
A Decade of Research: Assessing Change in the Technical Communication Classroom Using Online Portfolios ↗
Abstract
Over a period of 10 years, we have developed a sustainable process of online portfolio assessment that demonstrates both reliability and validity, using both qualitative and quantitative measures. The sustainable cycle is that, each semester, we assess a random sampling of the students' work that they have posted, as per our instructions, in an online portfolio. During the reading, the faculty score the documents for 11 variables, including writing, content, audience awareness, and document design. We achieved validity by a modified online Delphi that led to a redefinition of the construct of technical communication itself; we achieved reliability by adjudication resulting in adjacent scores. The results of our assessment meet the requirements of ABET and result in a continual cycle of improvement for our technical communication curriculum. Results from three semesters show an improving correlation between the course grade and the overall, holistic portfolio score.
-
From Monologue to Dialog to Chorus: The Place of Instrumental Discourse in English Studies and Technical Communication ↗
Abstract
One way to resolve some of the conflict in English studies and technical communication over their diminishing cultural capital is to recognize the place of instrumental discourse in communication studies. Instrumental discourse is individually verified social agreements to coordinate and control physical actions. One purpose of literary works is to voice new concerns about social inequities. A purpose of rhetoric is to persuade others of the validity of those concerns. Instrumental discourse registers agreements about those concerns and brings them to temporary closure in laws, instructions, contracts, and constitutions. Instrumental discourse is the culmination of a process that often begins with a literary monolog, is continued in many rhetorical dialogs, and ends, for a while, in a chorus of approval. Each phase of this communication process—monolog, dialog, and chorus—has a place in English studies. If more English studies faculty would recognize the need to study the communications that promote dissensus and consensus, then they might contribute more to global discussions about social justice, cooperation, and sustainability, and they might gain more cultural capital and social influence.
July 2006
-
Teaching a Distance Education Version of the Technical Communication Service Course: Timesaving Strategies ↗
Abstract
The author has taught a distance education version of the undergraduate technical communication service course at Boise State University since 1997 and shares the strategies he has found to decrease the time instructors spend teaching online, thereby enabling them to use the time they do have to enhance their students' online experience. These strategies are distributed among four areas: management of collaboration, presentation of course material, grading, and interaction with students. For each one, the author presents the problems that may occur and approaches to resolving them. The article addresses a number of concerns expressed in the scholarly literature on distance education and is informed by surveys given to five sections of the author's course taught between 2001 and 2003. Interspersed through the article is an overview of some of the current research and commentary on distance education of particular interest to those teaching the technical communication service course via the Internet.
-
Ten Engineers Reading: Disjunctions between Preference and Practice in Civil Engineering Faculty Responses ↗
Abstract
Previous research has indicated that engineering faculty do not follow best practices when commenting on students' technical writing. However, it is unclear whether the faculty prefer to comment in these ineffective ways, or whether they prefer more effective practices but simply do not enact them. This study adapts a well known study of response in composition to ask whether engineering faculty prefer authoritative, form-focused comments, or whether they may prefer to write different sorts of comments. We asked ten civil engineering faculty to comment on a sample paper and then rank their preferences for provided versions of comments on the same paper. One provided version emphasized comments on content, one emphasized comments on form, and one was balanced. Comparisons of the respondents' preferences and practices suggest that the engineering faculty recognize and value content-focused, non-authoritative responses, but generally do not write comments that conform to these values. We consider the implication of these findings for research on response to technical writing as well as for technical writing faculty in their own course. While recognizing the need for more research, we also discuss ways in which writing professionals, including WAC administrators and technical writing professors, can encourage engineering faculty to enact their preferences for response styles that reflect best practices.
-
Abstract
This study analyzes the performance and attitudes of technical writing students in PowerPoint-enhanced and in non- PowerPoint lectures. Four classes of upper-level undergraduates ( n = 84) at a mid-sized, Southern university taking a one-semester technical writing course were surveyed at the beginning and end of the course about their perceptions of PowerPoint. Of the four sections, two classes were instructed using traditional lecture materials (teacher at podium, chalkboard, handouts); the other two sections were instructed with PowerPoint presentations. All four classes were given the same pre- and post-test to measure performance over the course of the semester. Traditional lecture or PowerPoint presentations consisted of at least 50% of the course, with the remaining time spent on exercises and small group work. Results reveal that while most students say they preferred PowerPoint, performance scores were higher in the sections with the traditional lecture format.
April 2006
-
Legitimizing Technical Communication in English Departments: Carolyn Miller's “Humanistic Rationale for Technical Writing” ↗
Abstract
Carolyn Miller's oft-cited “Humanistic Rationale for Technical Writing,” published in 1979, tries to give technical communication faculty more cultural capital in English departments controlled by literature professors. Miller replaces a positivistic emphasis in technical communication pedagogy with rhetoric. She shows how technical knowledge is produced by individual activity and social affirmation and not by objective descriptions of sensory impressions. Her “Rationale” is an attempt to change institutional and discursive structures by persuading literature professors that technical communication can have as much distinction in the academy as literature.
-
Abstract
The purposes of this study are to determine the current status of scholarship published in five major technical communication journals about women and feminism and to identify changes in focus that may have occurred over the last five years. We begin with a discussion of the frequency of publication for articles whose titles have keywords relating to women and feminism. After identifying 21 articles, we consider the thematic patterns in the narrowed corpus. We conclude that scholarly publication about women and feminism in technical communication has moved from a moderate or radical concern for inclusion to a postmodern concern for critique of visual, verbal, and mechanical “technologies,” which previously were not considered political.
-
Charles Morris's Semiotic Model and Analytical Studies of Visual and Verbal Representations in Technical Communication ↗
Abstract
In this article, the author demonstrates that the semiotic model proposed by Charles Morris enables us to optimize our understanding of technical communication practices and provides a good point of inquiry. To illustrate this point, the author exemplifies the semiotic approaches by scholars in technical communication and elaborates Morris's model through analyzing visual and verbal elements of technical communication brochures from semantic, syntactic, and pragmatic levels. The discussion of semiotic approach reinforced by various examples illustrates that the semiotic model can be a tangible theoretical and practical tool to help students and practitioners study and analyze the use of visual and verbal elements in technical communication.
-
Abstract
In this article, I present findings from a discourse analysis of an often-overlooked genre of technical communication, regulatory writing. The study focuses on post-bellum regulations that disproportionately affected African Americans and the historical contexts in which the regulations were written. Historically, African Americans of all socioeconomic backgrounds have maintained an implicit mistrust of government regulations and the government officials who write them. The justification for this mistrust is deeply rooted in the fact that for decades regulations were not written to protect the rights of African Americans nor was their input considered in regulatory writing. In Communicating Across Cultures, Stella Ting-Toomey argues, “if conflict parties do not trust each other, they tend to move away (cognitively, affectively and physically) from each other rather than struggle side by side in negotiation” [1, p. 222]. This study reveals rhetorical strategies used in historical regulatory writing that may still impact the ethos of regulatory writers.
January 2006
-
Abstract
The readability of technical writing, and technical manuals in particular, especially for second language readers, can be noticeably improved by pairing Theme with Given and Rheme with New. This allows for faster processing of text and easier access to the “method of development” of the text. Typical Theme-Rheme patterns are described, and the notion of the “point of a text” is introduced. These concepts are applied to technical writing and the reader is then invited to evaluate the improvements in readability in a small sample of texts.
-
Guest Editorial: A Response to Patrick Moore's “Questioning the Motives of Technical Communication and Rhetoric: Steven Katz's ‘Ethic of Expediency’” ↗
Abstract
In my 1992 College English article “The Ethic of Expediency: Classical Rhetoric, Technology, and the Holocaust” [1], I looked at the implications of a Nazi memo whose sole purpose was to improve the efficiency of the gassing vans, in order to begin to try to understand and discuss the negative uses and ethical abuses to which technical communication, and deliberative rhetoric generally, could be taken by the powerful and unscrupulous. In “Questioning the Motives of Technical Communication and Rhetoric: Steven Katz's ‘Ethic of Expediency’” [2], Patrick Moore accuses me of ignoring alternate translations, citing out of context, and focusing on the negative meaning of words to make my case. The point at issue in these charges, I believe, is whether (and to what degree) Aristotle meant to base deliberative discourse on “expediency.” I will take each of these charges up one at a time to explore them more thoroughly, discuss their interrelations, and then conclude with a few observations of my own.
July 2005
-
Abstract
In this article we focus on professional readers who have to write recommendations in an online environment. We address the question whether taking notes on screen influences the reading process and the quality of the recommendations in terms of applicability, completeness, and persuasiveness. Seven participants each composed two pieces of advice on technical communication issues. They could use an electronic Notepad whenever they wished. Taking notes appeared to influence advice quality negatively, which may be caused by attention shifts from reading to taking notes on screen. Although we could not find a relationship between the contents of the notes and advice quality, we noted differences in note-taking approaches between the participants.
-
Abstract
Many technical documents present information both graphically and verbally. While much is known about the verbal tools of technical professionals, technical graphics have been less fully examined. Here the drawings of a United States patent are examined revealing a system for organizing and presenting visual information that is analogous to commonly-used models for organizing and presenting verbal information.
April 2005
-
Abstract
The growth of international online access has given rise to a new production method—international outsourcing—that has important implications for technical communication practices. Successful interactions within international outsourcing require individuals to understand how cultural factors could affect online interactions. Today's technical communication students therefore need to understand how factors of culture and media could affect the success with which they operate in international outsourcing activities. This article provides technical communication instructors with a series of Web-based exercises they can use to familiarize students with different aspects that can affect intercultural online interactions. It also provides a series of online resources students can use to enhance their understanding of cross-cultural communication in cyberspace.
-
Abstract
This study investigates whether Iconic Linkage—the use of the identical wording to present the same information recurring in a text—can improve the usability of user guides. Iconic Linkage is a writing strategy that potentially allows users to work more quickly and effectively and which promotes better retention of information. The usefulness of Iconic Linkage was tested in a laboratory-based usability study that combined: 1) objective task-based evaluation; and 2) users' subjective evaluations of a software program used in recording parliamentary debates. A post-test survey designed to test subjects' retention of information contained in the user guides was also administered. The study shows that Iconic Linkage significantly improved usability of the user guide: in all tasks, subjects worked more effectively and made fewer mistakes; while in the three timed tasks, subjects completed the tasks much more quickly. Subjects also gave higher ratings for the software and their retention of information was noticeably improved.
-
Abstract
One goal of college technical writing courses is to prepare students for real-world writing situations. Business writing textbooks function similarly, using guidelines, sample assignments, and model documents to help students develop rhetorical strategies to use in the workplace. Students attend class, or read and perform exercises in a textbook, with the faith that these skills will apply to workplace writing. In an attempt to better understand the similarities and differences between industry and academe's expectations of one genre of workplace writing, the memo, we compared the perceptions of memo quality by engineering faculty, students, and practitioners. All three groups responded to three sample memos taken from textbooks used by engineering professors in their undergraduate classrooms. The results indicate that students' and engineers' opinions of memo quality were more closely related to one another than to professors' comments, focusing on content, while professors were the most critical of style issues.
January 2005
-
Abstract
Creating a community history Web site is a way for technical communication practitioners, students, and teachers to improve their expertise while performing a valuable public service. Developers of this kind of Web site combine personal interest in the history and culture of their chosen communities with professional interest in a wide range of skills: for example, online research, Web site design, creation of artwork, photography, graphics editing, collaboration, professional/technical writing, as well as site publication and promotion. Technical communicators working on community history Web sites enjoy creative freedom that makes these projects especially engaging and fun. While learning about subjects of particular interest and improving professional skills, developers gain the satisfaction of trying to help communities increase civic pride and heritage tourism. Also, the technical communication profession benefits when its members demonstrate good citizenship to employers, other constituencies, and the public.
-
Abstract
Individual students in two different sections of an undergraduate civil engineering laboratory were tasked with preparing three professional-quality laboratory reports. The teaching assistant and/or instructor used established criteria to grade the first two reports prepared by students in one section. The first two reports prepared by students in the other section were peer evaluated by assigned fellow students within the same laboratory section using identical grading criteria. The peer evaluated section had a higher class average than the teaching assistant/instructor graded section on the fist two reports. The third report prepared by students from both sections was graded by a professional educator/architect without knowledge of a student's class section. The peer evaluation students also had a higher class average on the third report, suggesting that the peer evaluation process may have positively contributed to those students' writing skills.
-
Abstract
The recent trend of incorporating more visuals into communication challenges technical communicators, who must now possess both verbal and visual literacy. Despite all the recent scholarship on visual aspects of technical communication, technical communicators lack thorough guidelines for selecting and composing effective images that convey thematic and conceptual information, or what Schriver calls “stage-setting” images. This article reviews existing literature in visual communication and reports results of a study that assessed readers' opinions of themes conveyed by specific example images. It then suggests that the rhetorical tropes of metonymy and synecdoche can be used to identify images for conveying certain themes, and that successful stage-setting images will show intrinsic, not extrinsic, relationships to their thematic subject matter.
October 2004
-
Abstract
A significant problem in technical communication is persuading the user that the information is accurate, valid, and useful. All too often, technical communicators treat users as members of their own culture. When authors do consider cultural issues, they often focus on matters such as vocabulary, visuals, and organization. Other strategies, however, can be useful in gaining acceptance of technical information in cross-cultural situations. For example, the communication theory of compliance-gaining offers suggestions for how the technical communicators can adapt the text to enhance user acceptance when communicating to members of their own culture as well as when communicating across cultures. Communicators can use promises, threats, demonstrate positive and negative outcomes, extend friendliness, etc., to develop the text. In this article, I will explain several compliance-gaining strategies authors can use, identify rhetorical strategies they can combine with compliance-gaining strategies, show how these strategies can be effective in a cross-cultural environment by comparing the strategies in two sample cultures, and analyze a brief sample.
-
Abstract
My article traces the development, chronicles the impact, and explains the essence of Herbert Spencer's “The Philosophy of Style” (1852). Spencer's essay has had a significant influence on stylistics, especially in scientific and technical communication. Although in our generation Spencer's contribution to stylistics is not widely remembered, it ought to be. His single essay on this subject was seminal to modern theories about effective communication, not because it introduced new knowledge but because it was such a rhetorically astute synthesis of stylistic lore, designed to connect traditional rhetorical theory with 19th-century ideas about science, technology, and evolution. It was also influential because it was part of Spencer's grand “synthetic philosophy,” a prodigious body of books and essays that made him one of the most prominent thinkers of his time. Spencer's “Philosophy of Style” carried the day, and many following decades, with its description of the human mind as a symbol-processing machine, with its description of cognitive and affective dimensions of communication, and with its scientifically considered distillation of the fundamental components of effective style. We should read Spencer's essay and understand its impact not so much because we expect it to teach us new things about good style, but precisely because: 1) it's at the root of some very important concepts now familiar to us; 2) it synthesizes these concepts so impressively; 3) we can use it heuristically as we continue thinking about style; and 4) it provides a compact, accessible touchstone for exploring—with students, clients, and colleagues—the techniques of effective style for scientific and technical communication.
July 2004
-
Abstract
This article interprets technical communication research about sex differences according to social role theory, which argues that sex differences are enculturated through experiences associated with social positions in the family and the workplace. It reevaluates technical communication research about sex differences in communicative and collaborative styles in the classroom and the workplace and about the effects of the double bind that women experience in the workplace. The article concludes with a recommendation that theoretical frameworks explaining sex differences remain flexible and able to account for social change.
January 2004
-
Abstract
This article suggests ways of writing a truly effective cover letter, an extremely important document in the search for a job. First, features gleaned from 13 model letters in technical writing textbooks yield figures on the number of words, sentences, and paragraphs per letter, plus the average number of words per sentence and paragraph, information helpful to those with little or no knowledge of how to write a strong cover letter. Second, the article surveys what the textbook writers offer as advice about the rhetorical principles that should be employed in composing cover letters. One piece of advice given by almost all of the experts is that writers should try to exude an energetic attitude, yet these same authorities do not delineate just how to display such a posture in the letters themselves. Third, examination of the letters reveals that one way that experts insert verve into cover letters is to use verbals, particularly gerunds, participles, and infinitives. In fact, 92.58% of the sentences in the 13 model letters have some type of verbal in them. The advantage of employing verbals is that while they are used for other parts of speech, they still retain the residue of action in their meaning. Fourth, the article describes the results of a survey to determine the acceptance of such constructions in the minds of two sets of readers: first-year writing students and third-year technical writing students. In both groups, more than 75% of the students preferred a paragraph with verbals in it over a paragraph devoid of verbals. Finally, the article suggests “sentence combining” as a procedure for teaching technical writing students how to combine basic sentences into verbals to garner variety and economy, one of the hallmarks of technical writing.
-
Questioning the Motives of Technical Communication and Rhetoric: Steven Katz's “Ethic of Expediency” ↗
Abstract
By emphasizing the negative meanings of words, ignoring variations in translations, and quoting out of context, Steven B. Katz has argued in an influential article that an “ethic of expediency … underlies technical communication and deliberative rhetoric, and by extension writing pedagogy and practice based on it.” Katz's assertion misrepresents the motive of technical communication and its pedagogy, and it brings discredit to the professions of technical communication and the teaching of technical communication. His attempt to discredit the motive of technical communication is part of a two-millennia-long contest for status between intellectuals and the working classes, and it creates unnecessary mistrust at a time in history when people must focus even more on cooperating socially in order to sustain democratic cultures and our physical environment for future generations.
-
Abstract
Typeface personality impacts the rhetorical effect of students' documents, yet it receives little attention in textbooks. Technical writing students should stand the definition of “appropriate” in relation to typeface selection, the difference between type's functional and semantic properties, the difference between type family and personality, the effect of a typeface's history, and the contribution of a typeface's anatomy to its personality. Understanding these, students can make informed decisions about typeface appropriateness.
-
Abstract
We employ an array of terms to denote the visual; however, we have not yet agreed on a clear framework for understanding the function and relationship between visual concepts. I propose a literacy approach to the visual so that as educators, researchers, students, and practitioners, we acquire more than skills that rely on changing definitions and technologies but an intellectual faculty that provides the knowledge, understanding, and abilities that the visual affords. Through an analysis of arguments for visual instruction, I present the wayS in which scholars justify their claims about the visual. These arguments uncover the breadth and depth of the visual and contribute to a taxonomy of visual terminology.
October 2003
-
The Skills That Technical Communicators Need: An Investigation of Technical Communication Graduates, Managers, and Curricula ↗
Abstract
This study examines the skills that recent technical communication graduates and managers believe technical communication students need before entering business and industry as new technical communicators. Through questionnaires and interviews with recent graduates and managers of technical communication departments as well as an analysis of the participating schools' curricula, this study suggests areas where technical communication may need more preparation, including business operations, project management, problem-solving skills, and scientific and technical knowledge. Further research is needed at local, state, and national levels to analyze technical communication undergraduate curricula along with responses from recent graduates of technical communication programs and managers of technical communication programs. Only through continued research can we ensure that future technical communicators receive an education that eases their transition into the world of business and industry.
-
Book Reviews: Flash Effect: Science and the Rhetorical Origins of Cold War America, Visions and Revisions: Continuity and Change in Rhetoric and Composition, Usability Testing and Research, the Rhetoric of Risk: Technical Documentation in Hazardous Environments, Concepts in Composition: Theory and Practice in the Teaching of Writing, Accessing and Browsing Information and Communication ↗
-
Abstract
While research in international technical communication has flourished during the last 10 years, there has been little published on technical communication programs outside the United States. This article addresses this need by describing 12 representative academic technical communication programs in Germany, including Germany's first master's degree program. While there are no statistics on the number of technical communicators working in Germany, tekom (Gesellschaft für technische Kommunikation), the German professional society for technical communication, estimates roughly 4,400 members. While German academic programs in technical communication share many features with their counterparts in the United States, German academic programs do stress internships, foreign language study, and study abroad exchange programs more than technical communication programs in the United States.
July 2003
-
Expanding Internships to Enhance Academic-Industry Relations: A Perspective in Stakeholder Education ↗
Abstract
To improve technical communication education, educators and internship providers need to find ways to revise internship experiences so that educators, internship providers, and students/interns can use internship experiences in a way that benefits all three parties. This article uses a stakeholder education approach to propose two new kinds of internship processes to benefit all three groups. The first approach—colloquia—allows all three parties to interact via the same scheduled event. The second approach—student publications groups—shifts internship from a workplace to a school activity. By including such approaches into their curricula, technical communication programs can both improve their relationships with local internship providers and improve the training received by their students.
-
Abstract
As technical communication gains the technology to deliver dynamic custom documents, the importance of audience analysis increases. As a major factor in supporting dynamic adjustment of document content, the audience analysis must clearly capture the range of user goals and information needs in a flexible manner. Replacing a linear audience analysis model with a multidimensional model provides one method of achieving that flexibility. With a minimum of three separate dimensions to capture topic knowledge, detail required, and user cognitive ability, this model provides the writer a means of connecting content with information requirements and ensuring the dynamic document fits varying audience needs.
-
Abstract
Scientific and technical jargon—specialized vocabulary, usually Latinate—plays a vital role in scientific and technical communication. But its proper use continues to be a point of discussion because of our concern with audience adaptation, rhetorical exigence, rhetorical purpose, and ethics. We've focused on teaching students—and on convincing scientists, engineers, and other writers/speakers—to gear their specialized language to the recipients of their communication, to the occasion calling for their communication, to what they wish to accomplish through their communication, and to the ethical goals of safety, helpfulness, empowerment, and truth. These are exactly the sorts of things we should be doing. My contribution to this conversation is a reinforce ment and, I hope, an extension of the argument that we should also be teaching and convincing students and professionals: 1) to fully appreciate what makes jargon either good or bad; 2) to carefully distinguish jargon usage from other aspects of scientific and technical style; and 3) to recognize that in every context, even in communication among experts, jargon should be used judiciously—that is, in the most helpful, least taxing way.
April 2003
-
Technical Communication and Clinical Health Care: Improving Rural Emergency Trauma Care through Synchronous Videoconferencing ↗
Abstract
While debates continue over the effectiveness of innovative communication technologies to bring information and services to populations that have been underserved by such new technologies, a federally-funded program at the University of Vermont and Fletcher Allen Health Care (FAHC), Burlington, Vermont, has enabled trauma specialists to link with rural emergency room health care providers through a synchronous videoconferencing (telemedicine) network. Analysis of patient histories and surveys completed by the participating physicians after each use of the computer conferencing system as well as interviews and observations indicate that the FAHC consulting trauma specialists and the remotely located physicians felt the linkups do not interfere with standard ER procedures, that communication was at least adequate for all consultations, and that the consults improved the quality of care, for over half of the cases. Furthermore, interviews with rural ER physicians indicated that they saw the program operating as the first stage of FAHC's management of a patient to be transferred to that facility.
-
Drawing on Technical Writing Scholarship for the Teaching of Writing to Advanced Esl Students—A Writing Tutorial ↗
Abstract
The article outlines the technical writing tutorial (TWT) that preceded an advanced ESL writing course for students of English Philology at the Jagiellonian University. Having assessed the English skills of those students at the end of the semester, we found a statistically significant increase in the performance of the students who had taken the TWT in comparison to the control group who spent the time of TWT doing more traditional exercises. This result indicates that technical writing books and journals should be considered as an important source of information for teachers of writing to ESL students.
-
“Something in Motion and Something to Eat Attract the Crowd”: Cooking with Science at the 1893 World's Fair ↗
Abstract
Studying past examples of successful technical communication may offer insight into strategies that worked with technologies and audiences in an earlier time. This article examines the texts documenting a controversy before and during the Chicago World's Fair of 1893. Ellen Swallow Richards, chemist at the Massachusetts Institute of Technology, and Bertha Honore Palmer, president of the Fair's Board of Lady Managers, had distinctly different visions of how cooking technology should be presented. Palmer invited Richards to create a Model Kitchen in the Woman's Building, but Richards wanted to avoid gendering the new knowledge of nutrition and she fought to control her exhibit. The multimedia Richards used in her resulting Rumford Kitchen exhibit reminds us that sometimes an entertaining but familiar atmosphere might be the best way to introduce threatening new knowledge and technology, particularly to our increasingly international and intergenerational audiences.
January 2003
-
Abstract
The first part of this article shows that research in the history of technical communication has increased in quantity and sophistication over the last 20 years. Scholarship that describes how to teach with that information, however, has not followed, even though teaching the history of the field is a need recognized by several scholars. The article provides and defends four guidelines as a foundation to study ways to incorporate history into classroom lessons: 1) maintain a continued research interest in teaching history; 2) limit to technical rather than scientific discourse; 3) focus on English-language texts; and 4) focus on American texts, authors, and practices. The second part of the essay works within the guidelines to show a lesson that contrasts technical texts by Benjamin Franklin and Herbert Hoover. The lesson can help students see the difference in technical writing before and after the Industrial Revolution, a difference that mirrors their own transition from the university to the workforce.
October 2002
-
Abstract
Assessment continues to be an important issue for technical communicators in both practitioner and academic contexts. In this article, we investigate methods of program assessment used by corporate learning sites and we profile value add methods as a new way to both construct and evaluate academic programs in technical communication. Our goal is to introduce value added assessment methods as one way to supplement and expand current methods of program assessment. The article initially reviews Return on Investment (ROI) indicators as a widely used model for assessing programs. However, we are critical of these indicators, suggesting that they are biased against technical communication in both practitioner and academic contexts. The article then examines and critiques assessment methods from corporate training environments. These include methods employed by corporate universities and value added process-based assessment methods. The second half of the article profiles value added methods by applying them in a brief assessment of a technical communications certificate program. We conclude that while the program uses ROI indicators as a marketing device, the value the program brings and adds to its university is the “portal” it creates for university and business community collaboration. This value cannot be fully demonstrated solely through the use of ROI indicators. The article then discusses the kinds of programmatic negotiations value added processes require within university contexts that may impose non-value added activities on departments and programs. The article concludes by critically examining the appropriateness of corporate assessment methods for academic contexts.
-
Abstract
In this article I argue that technical communicators are in the position to foster users' commonsense understanding of products. The notion that technical communicators can increase the common sense of users is absent in the field of technical communication literature. Reasons for not recognizing the legitimacy of common sense range from its unexamined nature to a belief that it cannot be taught. After discussing different definitions of common sense, I suggest that including scenarios, common metaphors, and language that promotes procedural knowledge in product information can strengthen users' commonsense understanding of the products they use. Moreover, in failing to make use of commonsense appeals, technical communicators are ignoring a sound persuasive strategy.
July 2002
-
Extensible Markup Language: How Might it Alter the Software Documentation Process and the Role of the Technical Communicator? ↗
Abstract
This article describes the influence that Extensible Markup Language (XML) will have on the software documentation process and subsequently on the curricula of advanced undergraduate and master's programs in technical communication. XML, an evolving set of standards for storing and displaying information, uses nine components that make up the XML development process. Grouped into content, formatting, and language specifications, these components enhance organizations' ability to manage information more efficiently and accurately. As the XML development process is adopted, the software documentation process will evolve from a self-contained procedure into a more flexible, interactive process in which software documenters must work closely with a wide range of specialists. The changes that XML will have on the software documentation process will likewise have implications for programs in technical communication in the need to address new kinds of job descriptions, skill sets, and career paths of future technical communicators. The article recommends adaptations to existing courses, as well as new elective and required courses.
April 2002
-
Book Reviews: Comparative Rhetoric: An Historical and Cross-Cultural Introduction, Link/Age: Composing in the Online Classroom, Spurious Coin: A History of Science, Management, and Technical Writing, Authoring a Discipline: Scholarly Journals and the Post-World War II Emergence of Rhetoric and Composition, Writing Workplace Cultures: An Archaeology of Professional Writing, Rhetorical Scope and Performance: The Example of Technical Communication ↗
-
Abstract
XML is a recent Web design language that will enable technical communicators to produce documentation that can reuse information and present it across multiple types of media for diverse audiences. However, little is understood about how XML will impact technical communication in terms of theory, academic research, and pedagogy. In this article, I argue that XML requires more interdisciplinary approaches toward the teaching and research of technical communication, particularly with respect to the integration of technical and rhetorical knowledge.
January 2002
-
Abstract
The connection between language and empiricism is a central issue in technical writing and communication, more so than in other fields. Our field deals with technical and scientific knowledge which is oftentimes very definite and objective, yet there has been increasing recognition over the past few decades that this knowledge is socially constructed and rhetorically negotiated. Debates have ensued over the rhetoricity of technical communication in contrast to its empirical and instrumental aspects. W. V Quine, one of the most influential American philosophers of the twentieth century, however, rejected the distinction between empirical knowledge and knowledge stemming from language and social negotiation. Understanding technical writing and communication through the lens of Quine's theory ameliorates the tension between instrumental and rhetorical/humanistic views of technical discourse by recognizing the validity of both views and integrating the two. This understanding in turn will facilitate our pedagogical interactions with technical and scientific majors.
-
Abstract
If you wish to start an undergraduate professional and technical writing program at a small liberal arts college, you will find good arguments for your project in the educational writings of Sir Francis Bacon. Unlike other Renaissance Humanists, Bacon located the New Learning (what we now call the humanities) within the related contexts of scientific discovery and invention and professional training and development. His treatise, The Advancement of Learning, proposes to draw knowledge from and apply knowledge to the natural and social world. Bacon's curricular ideas can benefit emerging PTW programs in the humanities in three ways: They make a convincing apologia for most English departments and writing programs, wed humanistic education to public service, and provide a rich but practical theoretical framework for program development and administration.