Journal of Technical Writing and Communication
1534 articlesOctober 2010
-
Linguistics from the Perspective of the Theory of Models in Empirical Sciences: From Formal to Corpus Linguistics ↗
Abstract
The authors examine language from the perspective of models of empirical sciences, which discipline studies the relationship between reality, models, and formalisms. Such a perspective allows one to notice that linguistics approached within the classical framework share a number of problems with other experimental sciences studied initially exclusively within that framework because of making the same sort of assumptions. By examining solutions to some of these problems found in contemporary science, the authors point out alternative approaches, which could be relevant for linguistics research, and some of which have already been tested in language studies. In particular, Corpus Linguistics is presented as an especially promising approach, positioned to avoid many of the pitfalls of the classical framework. Consequently, it seems that the future of linguistics, from theoretical to applied, such as Technical Writing, must be embraced by Corpus Linguistics research.
-
Abstract
Few papers have been published that describe how authors go about writing book reviews. This article provides an account of the procedures used to write one specific book review. Examples are given to illustrate what is basically a three-stage procedure: making notes; creating a rough draft; and polishing the final version. Some comments on the language of book reviews are included.
-
Abstract
The fragmentation of science and medicine research in recent years has led to the creation of subdisciplines with distinct identities and ethics. Like many social communities, these subdisciplines have found websites of federal funding agencies such as the National Science Foundation (NSF) and National Institutes of Health (NIH) to be an effective and efficient home in which to solidify that identity and communicate those values. Despite the lack of collaborative, Web 2.0 technologies, the sites of NSF and NIH are able to communicate the ethics of the science communities they serve through rhetorical structures as diverse as graphics, page layout, and site structures. This article explores that role of NSF and NIH, including the rhetoric used, the ethics presented, and their broader implications.
July 2010
-
Abstract
This article analyzes the impact of the design of the Medicare handbook and website on individuals' ability to make effective decisions about prescription drug coverage. The article summarizes Medicare Part D, discusses the characteristics of potential enrollees, and provides an overview of document-based decision making. It uses a rhetorical framework to evaluate the Medicare documents as decision-making tools, arguing that design flaws hinder users'understanding, discourage them from taking appropriate action, and negatively shape perceptions of ethos. The article concludes by discussing implications for functional documents more generally, underscoring the importance of a design cycle that is both user-centered and performance-centered.
-
Abstract
Risk communication has been explored in technical communication for over 15 years, but it has been largely confined to communicating the risk of industrial activity, medical risks, or environmental threats to the public. Using the framework previous risk communication has provided, this article applies those ideas to research science, specifically to stem cell research, where government opposition until recently has limited this research, preventing it from potentially providing organs for those who need a replacement or more effective treatments for other diseases such as diabetes or Parkinson's disease. Risk communication in the United States and Europe is contrasted to delineate the greater effort being made in Europe to construct stem cell research socially for the researcher and the public.
-
The Coaching and Mentoring Process: The Obvious Knowledge and Skill Set for Organizational Communication Professors ↗
Abstract
This article explores the uses of coaching and mentoring as they apply to organizational communication professors. The authors contend that these professors already are proficient at coaching and mentoring and the coaching and mentoring processes are routinely undertaken as part of their standard university teaching responsibilities. As coaches, these faculty members assist their students in improving student communication abilities through observation, discussion, and follow-up. As mentors, these faculty members enter into a developmental relationship with students that extend beyond the classroom. A greater knowledge of coaching and mentoring will enhance instructional efforts and benefit students in multiple ways.
-
Abstract
Steven Katz's “The Ethic of Expediency” has become a reference point for discussions of ethics since its 1992 publication. Previously, this author assessed Katz's rhetorical analysis of Nazi technical communication against current research on the Holocaust and noted that scholarship suggests ideology rather than technological expediency as its motivating force. Yet implicit in the author's critique are two remaining questions, namely: What other rhetorical interpretations may be possible of the SS technical memo analyzed by Katz? And is Katz, who makes broad generalizations about Western rhetoric based on a single document, supported by examples of other Nazi technical communications? This article explores alternate interpretations of the SS memo suggested by the arguments of Rivers and Moore; presents the author's view that the Katz thesis decontextualizes the memo and that historical context argues for a primarily ideological ethos; and reviews sources for English translations of other Nazi documents.
-
Abstract
Recently, human and user-centered design methods have challenged older system-centered practices, enriching resources and providing better technological artifacts for end-users. This article argues that though design has become more user-centered, something is still lacking: more opportunities exist for articulating feedback already present in technology-culture networks. To encourage the recovery of this feedback, this article examines discourses surrounding transportation technology and the Chōra, the variety of stakeholders who shape the progression of technology through use, negation, or re-appropriation. While this article is far from a programmatic or procedural document, it suggests opening design processes to a variety of cultural inputs beyond those marked as “users.” It attempts to open a space for technical communicators in these multifaceted feedback loops, where Chōral influences are articulated and rearticulated for more effective transportation design.
-
An Application of Robert Gagné's Nine Events of Instruction to the Teaching of Website Localization ↗
Abstract
Website localization is an important part of international technical communication. However, at present, few technical communication programs offer courses in localization. This article provides an overview of a course devised to familiarize students with ideas and approaches related to website localization. The course was based upon Robert Gagné's nine events of instruction—an approach that allowed students to move from the learning of abstract ideas to the application of knowledge to the website localization process.
April 2010
-
Abstract
We evaluate 45 jobs professional communicators might occupy. Specifically, we examine the impact of creativity on careers that may become more or less easily outsourced domestically or offshore in the future. We are unable to find any particular relationship between creativity, per se, and job security. Instead, we find that people with knowledge of the processes required for innovation are more valued by industry than those recognized as creative. We suggest that to be prepared for the evolution of the global economy, technical communicators and their educators should understand “innovation” in its formal context and be able to apply that knowledge in their workplaces and classrooms.
-
Abstract
2008 marked the 10-year Anniversary of the Open Source movement, which has had a substantial impact on not only software production and adoption, but also on the sharing and distribution of information. Technical communication as a discipline has taken some advantage of the movement or its derivative software, but this article argues not as much as it could or should. We have adopted Open Source Software (OSS) to manage courses or websites; we have, following the principles of Open Source, made some intellectual resources available; but we have not developed a truly open—open to access, open to use, and open to edit—pedagogical resource that teachers of technical and professional communication courses at every level can rely on to craft free offerings to their students. Now is the ideal time to consider developing OpenTechComm. This article makes the case for why and how it could be implemented.
-
Introducing China's First Comprehensive Technical Writing Book: On Technological Subjects by Song Yingxing ↗
Abstract
On Technological Subjects, written and completed by Song Yingxing in 1628, is China's first comprehensive technical writing book intended for a general audience. Its 18 chapters cover nearly all the major technological subjects of its time, such as growing grains, weaving clothes, making sugar and salt, and building ships. The book accommodates various audiences' information needs by combining equipment and material descriptions, process explanations, and task instructions. To help audiences understand his descriptions and to follow his instructions more effectively, the author integrates 100 full-page detailed drawings. Another mechanism that the author uses to help his audiences complete the described tasks is using names (nouns) instead of action-oriented phrases for most of the chapter titles. Song's book embodies several important features in modern technical communication, especially in China's modern technical communication. The book should help international technical communicators understand China's modern technical communication from the perspectives of audience's awareness, organization of information, and use of visuals.
-
Abstract
Cross-cultural blunders caused by inappropriate use of language are a common problem in international professional communication. They cause misunderstanding, lead to business failures, and tend to be offensive at times. Such blunders may occur in business ads, slogans, products names, and instructions. Understanding their causes and finding solutions to them are of importance in international professional communication. By examining specific cases, the article analyzes the causes that lead to such blunders from a semantic perspective and concludes that indiscriminate use of the semantic meaning of a word, a lexical form, lexical sound, numbers, color words, and animal names of the target language is the major cause of causing cultural blunders in international professional communication. Along the way, the article also offers solutions to the problems identified.
-
Coverage of Team Science by Public Information Officers: Content Analysis of Press Releases about the National Science Foundation Science and Technology Centers ↗
Abstract
This study examines the content of press releases from the National Science Foundation (NSF) Science and Technology Centers (STCs) to determine how public information officers (PIOs) presented the outcomes of centers to journalists and the public. A total of 68 press releases were analyzed for type of news covered, visibility of centers and their funding agency, extent of inter-institutional cooperation in the issuance of releases, and players covered. Three-quarters of STC releases mentioned the center, but less than half mentioned the NSF STC program and one-quarter didn't mention the center name at all. PIOs covering the STCs mainly issued research-oriented press releases accredited to their own institution. There was a low level of inter-institutional cooperation, with 13% of press releases jointly issued. Compared to research results and institutional news, which together accounted for 82% of the news events, broader activities such as knowledge transfer, diversity enhancement, and education were much less visible.
-
Abstract
Networked electronic text—fragmentary, mutable, connected, and instantly accessible from any computer or handheld device—challenges traditional notions of textual coherence and composition, offering affordances far beyond those possible in traditional, print-based texts, including those made available electronically. Such texts become tools, passively awaiting a user who activates, assimilates, and adapts their contents to his or her particular situation. This article explores the creators' role in such texts, roles that remain underappreciated, unstudied, and misunderstood as a new, and necessary, form of composition activity. Their work is not considered authorship in most traditional senses of composition; although it involves a number of traditional authorial tasks: the decision to connect certain fragments to others, to add affordances beyond those allowed by print, creates the potential for structural coherence and viability of a networked text, potential then realized by users, who themselves become authors of this continually changing text.
January 2010
-
Abstract
While scholars have begun to write a history of reports and instructions, little scholarship exists on the history of proposals. To fill this gap, I analyze proposals written by Dorothy Wordsworth and Anne Macvicar Grant, ca. 1800. My analysis uses contemporary rhetorical theory to determine how they structured their writing and incorporated rhetorical appeals to achieve their goals. My findings show that their texts should be placed on a continuum of the history and development of the proposal genre. Further findings suggest that their use of contemporary rhetorical theories authorized Wordsworth's and Grant's discourse to successfully affect change.
-
Abstract
This article studies the history of one of the most critical, unresolved problems in mechanized agriculture: Tractor operators do not read the operation manuals, particularly the safety warnings. The result: sustained death and injury of these operators for well over a century. The article tracks the emergence of warnings in tractor operator manuals found in the archives of the University of Nebraska Tractor Test Museum (1919–2007), describes efforts of manufacturers during this time to alert operators to dangers associated with tractors, and concludes with a summary of current research on tractor safety and the problem that remains unresolved: how to change the culture of farmers who use these implements, critical to agriculture production, to encourage them to read and follow safety practices.
-
Technical Communication Internship Requirements in the Academic Economy: How We Compare among Ourselves and across other Applied Fields ↗
Abstract
This article reports a study of internship requirements in technical communication programs compared with three established professions and one emerging profession that have certification or licensing requirements for practitioners. The study addresses three questions about technical communication internship programs: 1) Are internships offered as a way to fulfill program academic credit requirements? 2) If internships are offered, are they required or elective? 3) What are the minimum/maximum academic credits allowed for internships toward fulfillment of program requirements and the number of workplace hours of internship required? To answer these questions we focused on three elements of internship program management: academic credits, workplace hours per academic credit, and total workplace hours required. Our findings indicate that there is considerable disparity for these factors among programs in our field and that we lack criteria similar to those used in established professions for internships.
-
Abstract
The tools and techniques utilized in the technical communications profession are constantly improving and changing. Information Technology (IT) organizations devote the necessary resources to equip and train engineering, marketing, and sales teams, but often fail to do so for technical documentation teams. Many IT organizations tend to view documentation as an afterthought; however, consumers of IT products frequently base their purchasing decisions on the end user documentation's content, layout, and presentation. Documentation teams play a unique role in IT organizations as they help to build and create a public identity through end user manuals and the corporate website, as well as maintain intellectual knowledge through knowledge sharing and management. The technical communicator “ makes sense” of complex engineering specifications by creating user-friendly manuals for the layman. The practitioner who compiles and records this complex information is a valuable resource to any IT organization. Therefore, on-going training for technical documentation teams is essential to stay competitive in the fast-paced technical market. Technical communicators in IT organizations who only write end user manuals are becoming a rarity. Research indicates a marked trend toward technical writers in multiple roles and varied responsibilities that include web design and development, and business systems analysis functions. Although these added roles and responsibilities require training on some of the newer software tools and more complex programming tools, technical communicators are experiencing difficulty keeping pace with these tools. This article discusses technical documentation teams in IT organizations and provides an on-going training assessment to help technical documentation managers identify their team's strengths and weaknesses. In addition, measures and results from a study conducted at eight IT organizations, are provided to show the effect of how the integration of on-going training for documentation teams enhances individual competency and improves team performance.
October 2009
-
Abstract
This article provides a fresh examination of claims that biotechnology and other high profile areas of scientific research and development create a “virtuous cycle” that delivers benefits to society and ecology through an array of consumer products. Specifically, the article investigates who and what has agency in this virtuous cycle and who and what does not. I argue that official discourses on and definitions of biotechnology create strict demarcations not only on who can act in relation to biotechnology research development options, but also on where and at which stages of the virtuous cycle these agents can act. For example, scientists are presented as passive rather than active agents whose influence is limited to the laboratory context despite rhetorical use of their identity and credibility across all contexts of product development and consumption explored. Agency is highly significant in biotechnology and other areas of scientific advance because it determines who or what has moral decision making power regarding the place of new technologies in society. The article concludes with a discussion of the social and ethical impacts of these demarcations of agency in biotechnology's virtuous cycle.
-
The Two-Semester Thesis Model: Emphasizing Research in Undergraduate Technical Communication Curricula ↗
Abstract
This article addresses previous arguments that call for increased emphasis on research in technical communication programs. Focusing on the value of scholarly-based research at the undergraduate level, we present New Mexico Tech's thesis model as an example of helping students develop familiarity with research skills and methods. This two-semester sequence serves as a capstone experience for students' writing, designing, editing, and presentation skills. It also involves members of our corporate advisory board and provides an opportunity to teach students to understand and apply research methods to unique projects, skills we argue will benefit students no matter what environments they enter upon graduation.
-
Abstract
This article considers a case in which editors created for themselves an amount of power and authority within an organization through technological innovation. Using retrospective analysis and e-mail interviews, the author discusses his own previous experience as a technical editor at a U.S. Government-run research facility when electronic editing was introduced and used. The introduction of electronic editing, the author argues, was an example of technological innovation, which, as other researchers have demonstrated, can create authority within an organization.
-
“Proof” in Pictures: Visual Evidence and Meaning Making in the Ivory-Billed Woodpecker Controversy ↗
Abstract
This case study focuses on images in three Science articles on the ivory-billed woodpecker, whose rediscovery was recently heralded. Because the primary piece of evidence is a frustratingly fuzzy four-second video, two groups of authors ultimately disagree on its interpretation and the same still video images that are used to argue for the sighting are used to argue against it. Given that the authors are making taxonomic arguments, images that closely resemble reality are employed. These images, like all images, are coded, and this analysis seeks to unlock these visual codes to reveal how meaning is made at the site of production, the site of the image, and the site of the audience. It also exposes how meaning making at the site of the image fueled the controversy.
-
Abstract
This article proposes a taxonomy of scientific titles: those staking claims; those setting problems; and those conveying themes. A close analysis of the deep structure of these titles suggests that their goal is the maximization of information content within a short compass, a compression that permits their easy retrieval in computerized searches. Placing these titles into the context provided by Gross, Harmon, and Reidy's Communicating Science suggests further that titles evolved to this point by adapting to changes in systems of information retrieval.
-
Abstract
In our case study, we examined the instant messaging (IM) workplace discourse of a pair of expert IM users. We found that the participants maintained discourse cohesion and thus coherence via short, rapidly sent transmissions that created uninterrupted transmission sequences. Such uninterrupted transmission sequences allowed each participant to maintain the floor. Also, the participants used topicalizations and performative verbs to maintain coherence. We also found that the participants' use of short transmissions may have ambiguated their enactment of their institutional roles and the rights afforded to them by those roles.
-
Abstract
This article presents a study investigating how people deal with procedural documents when using a new domestic appliance. An observational study was carried out in a quasi-experimental setting in order to outline the behavior of users encountering and using an appliance for the first time. The purpose of this observation was to identify two kinds of factors: on the one hand, factors inciting the use of procedural documents accompanying appliances, and on the other hand, design features facilitating the use of these documents when looking for specific information. User behavior and strategies were categorized using two kinds of indicators: 1) the number of times the documents were examined prior to contact with the appliance and/or while carrying out the prescribed tasks; and 2) the total time required to locate information in three different kinds of documents: Text only, Picture only, Text + Picture. Results show that 16 participants out of 30 spontaneously used the procedural documents before starting to use the appliance. However, during the session, 27 participants consulted the documents at least once. This consultation was determined by the task to carry out and the complexity level of the task. Otherwise, results show that time taken to locate information was shortest when instructions were displayed in text-and-picture format.
July 2009
-
Abstract
This article questions how professional communication genres already well established in print form have been changing as they are transplanted into digital media like the Web. Whereas some technology-oriented genre research has sought how a new medium provides genres with new technological features, this article argues that a more insightful approach would seek how a new medium, together with its users, provides genres with new rhetorical situations. To operationally define rhetorical situations, I adapt Lloyd Bitzer's three situational dimensions of exigence, audience, and constraints. Then, to illustrate how the new rhetorical situations of the Web can influence a genre, I explore the genre of the résumé. Drawing on a survey of 100 Web résumé authors and an analysis of their sites, I show that as each of the three dimensions of the résumé's traditional rhetorical situation has opened itself to greater diversity on the Web, the Web version of the résumé genre has correspondingly reoriented itself. Hence, genres change in response not just to the new medium's technology per se but to the new rhetorical situations that the medium hosts.
-
Introducing Heuristics of Cultural Dimensions into the Service-Level Technical Communication Classroom ↗
Abstract
A significant problem for practitioners of technical communication is to gain the skills to compete in a global, multicultural work environment. Instructors of technical communication can provide future practitioners with the tools to compete and excel in this global environment by introducing heuristics of cultural dimensions into the service-level classroom. By practicing how to use these heuristics in “real-world” contexts, instructors can prepare students to function as both information architects and symbolic-analytic operators within this global work environment. In this article, I first examine common cultural heuristics as they pertain to business communication. Next, I articulate how technical communicators can benefit from incorporating these heuristics into the classroom. Finally, I offer a pedagogical approach to introducing heuristics of cultural dimensions into the service-level technical communication classroom.
-
Abstract
This article explores the social meaning of locale in mobile communication research and introduces an approach of user localization to study technology integration. It investigates how locale forms an essential role in mobile communication in the way that practice, agency, and identities are articulated into a user localization process of incorporating technology into user's everyday life. It argues that the use of mobile communication technology is both a complex and dynamic interaction with its surrounding social, cultural, technological, and economic conditions, and an articulation work of self and locale.
-
Book Reviews: Together with Technology: Writing Review, Enculturation and Technological Mediation, Motives for Metaphor in Scientific and Technical Communication, the Global English Style Guide: Writing Clear, Translatable Documentation for a Global Market, Outsourcing Technical Communication: Issues, Policies and Practices ↗
-
Abstract
Many authors give advice to students about how to write the Introduction section of their articles. Some give examples of different ways of doing this in general, and a few discuss the opening sentence in particular. In this article, 13 different types of opening sentences are outlined, and their usage contrasted in British and American journals in the Sciences and Social Sciences. Implications for teaching are considered.
-
Risk Communication, Space, and Findability in the Public Sphere: A Case Study of a Physical and Online Information Center ↗
Abstract
This article uses theories of space and findability to analyze a public information center as an example of multi-modal risk communication. The Yucca Mountain Information Center is an informational space created by the Department of Energy to inform the public about the proposed nuclear waste repository planned for Yucca Mountain, Nevada. As a public space, the Center uses fact sheets, posters, and three-dimensional displays to make arguments about the storage of nuclear waste; we argue that the physical space, text, displays, and online space are all elements of risk communication. We offer a new way to read these elements of risk communication and suggest potential opportunities for public agency.
-
Abstract
Those who submit manuscripts to academic journals may benefit from a better understanding of how editors weigh ethics in their interactions with authors. In an attempt to ascertain and to understand editors' ethics, we interviewed 3 current academic journal editors of technical and/or business communication journals. We asked them about the ethical dilemmas they encountered while working with authors, whether the editors formally or informally followed a “code of ethics,” and if they felt obligated to maintain any ethical codes in particular. In this article, we discuss the ethical dimensions of editorial practices using specific ethical scenarios provided by these three editors. We then analyze these scenarios using traditional ethical models in our field but also in terms of a less-known but powerful model of ethical analysis originally proposed by the philosopher C. S. Peirce. We argue that Peirce's “community of inquiry” ethics model best describes these journal editors' ethics when working with authors.