Journal of Technical Writing and Communication

314 articles
Year: Topic: Clear
Export:
multilingual writers ×

October 2016

  1. Supporting Human Dignity and Human Rights
    Abstract

    Technical and professional communication (TPC), like human-centered design, has long been human centric. But TPC struggles with the complexities of determining which humans are at the center of our work. This article proposes that an explicit consideration of human dignity and human rights can help us to navigate these complexities by reflecting upon whether our work harmonizes with the notion that every person has intrinsic worth. To illustrate, I present findings from exploratory research with nonelite Rwandan youth in which participants conveyed the roles and effects of technology-mediated communication and information and communication technology in their lives. I assert that as TPC begins engaging more explicitly with human dignity and human rights, we should adopt a perspective inspired by human-centered design scholar Richard Buchanan: embracing human dignity and human rights as the first principle of communication and the foundational value of the TPC field.

    doi:10.1177/0047281616653496

April 2016

  1. Bonding With the Nuclear Industry
    Abstract

    This article describes how a special kind of academe–industry collaboration—based on a joint appointment agreement between a university and an industry site—was set up, promoted, and experienced by a professor of technical communication and his student interns. To illustrate the nature and value of this kind of collaboration, the article discusses several of the professor’s research projects, and the teaching scenario connected with this collaboration, as well as the experience of the student interns. The keys to success for such an exchange are to (a) create a clearly structured agreement that is easy for both parties to implement within their respective institutions, (b) promote the agreement to administrators and employees at both institutions, and (c) launch into the exchange with enthusiasm for learning, networking, and finding research projects.

    doi:10.1177/0047281616633598

January 2016

  1. Are We “There” Yet? The Treatment of Gender and Feminism in Technical, Business, and Workplace Writing Studies
    Abstract

    This article reexamines the treatment of gender and feminism in technical, business, and workplace writing studies—areas in which the three of us teach. Surprisingly, the published discourse of our field seems to implicitly minimize the gendered nature of business and technical writing workplaces and classrooms. To understand this apparent lack of focus, we review five technical and business communication academic journals and build on previous quantitative evaluations done by Isabelle Thompson in 1999 and by Isabelle Thompson Elizabeth Overman Smith in 2006. We also review nine popular textbooks using a content analysis method based on Thompson’s work. Finally, we discuss current research in feminist pedagogies vis-à-vis these results and our own experiences in the professional writing classroom.

    doi:10.1177/0047281615600637
  2. Content Management Systems, Bittorrent Trackers, and Large-Scale Rhetorical Genres
    Abstract

    Scholars of rhetoric and writing have long recognized the mediated nature of rhetorical action. From Plato’s early indictments of writing as enemy of memoria to Burke’s recognition of instrumental causes to recent analyses of digital mediation, the study of meaning-making refuses one-to-one, transparent theories of communication, instead recognizing that there is more to rhetorical action than humans. This article follows the trail of Haas, Swarts, and others arguing that analyses of mediation uncover much about human motives, digital communities, and rhetorical action. I argue that technologies often function as rhetorical genres, providing what Miller characterizes as “typified rhetorical actions based in recurrent situations” that occur in uniquely digital spaces. Working from sites of participatory archival creation and curation, I argue that invisible rhetorical genres operating at macroscopic levels of scale are central to shaping individual and communal activity in sites of distributed social production. To support this claim, I investigate two applications—a content management system called Gazelle and a bittorrent tracker called Ocelot—to demonstrate how largely invisible server-side software shapes rhetorical action, circumscribes individual agency, and cultivates community identity in sites of participatory archival curation. By articulating content management systems and other macroscopic software as rhetorical genres, I hope to extend nascent investigations into the medial capacities of digital tools that shape our collective digital experience.

    doi:10.1177/0047281615600634

October 2015

  1. From the Editor’s Desk: Reflections on an Increasingly Long Career
    doi:10.1177/0047281615585747
  2. Building Identity and Community Through Research
    Abstract

    A field’s identity and sustainability depend on its research as well as on programs, practice, and infrastructure. Research and practice have a reciprocal relationship, with practice identifying research questions and researchers answering those questions to improve practice. Technical communication research also has an exploratory purpose, using the knowledge and methods of the field to explain how texts work in a variety of contexts. A gap between research and practice developed in the 1990s. Defining explicitly how the parts of our research and our practice connect to form a whole will give the field a stronger identity

    doi:10.1177/0047281615585753

July 2015

  1. Bell, T. W. (2014). <i>Intellectual Privilege: Copyright, Common Law, and the Common Good</i>
    doi:10.1177/0047281615578852
  2. From a Marketplace to a Cultural Space
    Abstract

    Culture as a research site and tool has been well established in the field of intercultural business and technical communication. In recent years, the perspective of culture as an ongoing process responding to contextual forces has been widely embraced in the field. Acknowledging the dynamic nature of culture helps communicators make contextual evaluations in intercultural business communication practices. While researchers strive to examine the dynamic nature of culture and contextual factors’ influence on culture and communication, little efforts has been made to examine the process of a cultural element’s generation, development, and transmission. To understand the notion of culture as a dynamic process for effective intercultural business and technical practices, it is necessary to conceptualize or describe how a cultural element or unit originates and develops along an evolutionary path. In this study, we focus on how the online meme serves as an empirically useful unit of culture, explore an online meme’s evolution process when it successfully transfers from an online marketplace to cultural space, and identify the qualities that constitute the success of the online meme.

    doi:10.1177/0047281615578847

April 2015

  1. “Write Me a Better Story”: Writing Stories as a Diagnostic and Repair Practice for Automotive Technicians
    Abstract

    Although storytelling research is rarely applied to technical communication, I approach it as one way of technical communication practitioners and teachers might account for the social, creative, knowledge-intensive ways technical service work gets done. In particular, I look to the technical service work of automotive technicians at a repair shop in the Northwest. These technicians not only tell each other stories, but they also write stories about their diagnostic practices, or what they do to determine problems, and about their processes for addressing those problems—their actual repair work. But writing stories is more than instrumental. I argue that acts of storytelling are inseparably entangled with acts of accessing technical breakdowns, determining possible problems, and then producing acceptable solutions. For these technicians, writing stories and fixing cars intertwine. My central question, then, is how can technical communication researchers and teachers approach acts of storytelling in ways that offer us richer, more precise articulations of the relationship between writing and technical service work like that of fixing cars?

    doi:10.1177/0047281615569486

January 2015

  1. Assessing the Lexico-Grammatical Characteristics of a Corpus of College-Level Statistics Textbooks: Implications for Instruction and Practice
    Abstract

    A corpus of current editions of statistics textbooks was assessed to compare aspects and levels of readability for the topics of measures of center, line of fit, regression analysis, and regression inference. Analysis with lexical software of these text selections revealed that the large corpus can be described well by three index variables that summarize the lexical and grammatical complexity of the textbook excerpts. Assessment of those three variables indicates that substantial differences exist in the readability of the topics within textbooks with respect to lexical and grammatical complexity. This analysis suggests that general readability of introductory statistics topics within textbooks varies substantially and it is a recommendation that instructors: (1) be prepared to provide additional support for topics that are more grammatically and lexically complex, and (2) be aware that they can input their instructional materials into LexTutor VP or Coh-metrix as a quick screen for possible readability issues.

    doi:10.2190/tw.45.1.c
  2. Expanding Our Understanding of <i>Kairos</i>: Tracing Moral Panic and Risk Perception in the Debate over the Minnesota Sex Offender Program
    Abstract

    The Minnesota Sex Offender Program (MSOP) offers treatment to sex offenders civilly confined after they complete their prison sentences. In this article, we enhance the notion of kairos in rhetorical situations with the perceptions of risk and the sociological concept of moral panic by tracing three kairotic moments involving MSOP: the 1992 Dennis Linehan civil commitment case; the 2003 murder of college student Dru Sjodin; and the 2012 provisional discharge of Clarence Opheim. We examine the political, public, and media response to these events and provide the results of 21 interviews with stakeholders. In doing so, we hope to illustrate how moral panic and risk perception can so influence what seems the right choice at the right time that stakeholders may get caught in what we call kairotic cycles, where solutions to a problem are stymied by competing perceptions and by entrenched positions that reoccur over time and without resolution.

    doi:10.2190/tw.45.1.b

April 2014

  1. Proposal Pitfalls Plaguing Researchers: Can Technical Communicators Make a Difference?
    Abstract

    The facts bear out that the odds are against most scientific researchers and scholars—especially those just starting out—in their attempts to win funding for their research projects through their grant proposals. In this article, the author takes a close look at some of the proposal-related problems and pitfalls that have historically challenged scholarly grant seekers. The intellectual prowess and specialized training of academics can sometimes be their downfall, when it comes to persuading government agencies and foundations to fund their well conceived, but unconvincingly presented projects. In examining numerous studies, surveys, and insightful articles of experts in the genre of the research grant proposal, it becomes evident that technical communicators could quickly become the best friends of scholars, when the former harness the rhetorical and stylistic skills that are almost instinctive to them, and apply them to writing grant proposals, a task which is all too often a disappointing exercise for the latter.

    doi:10.2190/tw.44.2.f
  2. New Perspectives on the Technical Communication Internship: Professionalism in the Workplace
    Abstract

    This article argues for developing linked courses in technical communication where the instructor facilitates a service-learning curriculum and then serves as faculty advisor within subsequent internships. In these linked courses, students write technical documents before moving into internships where they write similar documents. Specifically, the article examines the results from one such class and offers both theoretical and practical advice for collaborating with nonprofit and creating internships that are beneficial for both the students and the nonprofit. In addition, the discussion highlights students' preparedness to enter the field of technical communication, as evidenced through their internship work and their final reflections. Through careful consideration of the nonprofit' responses, I suggest making changes to professional and technical communication curricula for linked courses and internships, including the addition of an objective of professionalism that teaches students to not only write in a professional manner, but to also consider their actions and responsibilities within the context of an organizational culture.

    doi:10.2190/tw.44.2.d
  3. Geopolitics of Grant Writing: Discursive and Stylistic Features of Nonprofit Grant Proposals in Nepal and the United States
    Abstract

    This study examines the global-local interplay of genre features in a select sample of nonprofit grant proposals from two particular sites—Nepal and the United States. Critically analyzing the carefully selected samples from both the sites on their own terms first and then in clusters (of Nepalese and American proposals) by exploiting the genre and discourse analysis theories and techniques published in genre, genre analysis, and grant proposal scholarship, this study attempts to examine the genre of nonprofit grant proposal in both comparative and non-comparative terms. While the study acknowledges that each instance of nonprofit grant proposal is unique, complex, and therefore non-generalizable, it does draw some broad generalizations about the similarities and differences in the rhetorical “moves,” organization, and/or composition strategies of grant writers from these two different geopolitical locations. The study finds that variations observed across samples and grant writers reflect the unique rhetorical situations of these writers, whereas uniformities have to do with the global circulation of Western genre forms in the rest of the world via global organizations like the United Nations and the International Monetary Fund—which are also the major donors in developing countries like Nepal. And finally, the study reaffirms the fact that constraints like funding agencies' guidelines and reviewers' preferences have a considerable influence on genre features and forms. That has been the case with both the Nepalese and American proposals sampled in this study.

    doi:10.2190/tw.44.2.c

January 2014

  1. An Important Link in the Chain Connecting Ancient Chinese Philosophy to Present-Day Style of Chinese Technical Communication: Introducing <i>Yellow Emperor's Classic of Internal Medicine</i>—China's First Comprehensive Medical Book
    Abstract

    Yellow Emperor's Classic of Internal Medicine, China's first comprehensive medical book, served as the key link between Yi Jing, which initiated China's high-context culture, and the high-context style of modern Chinese technical communication. In the form of dialogues between Yellow Emperor and his minister, its 24 fascicles cover four major topics of the organs, diagnosis, diseases, and treatments. While examining the body and discussing various diseases and treatments, the book expands on Yi Jing's philosophy through integrating three interrelated concepts: Tao, Yin and Yang, and Five Elements (word, fire, soil, metal, and water). In this way, the book, for the first time in Chinese history, explicitly treated humans and their behaviors as individual events conditioned by the natural context, emphasizing context as the conditioning force. This emphasis on context is manifest in modern Chinese technical communication as two textual devices of establishing personal relationships and creating ideal physical environments.

    doi:10.2190/tw.44.1.d

October 2013

  1. Metaphor-Laced Language of Computer Science and Receptor Community Users
    Abstract

    It is a well-attested fact among the academia that the terminology and discourse of computer science is pervaded with metaphors. Yet, almost all the studies on metaphor application in computer science have approached the issue of the metaphor use and its influence on the user-computer interaction from an intralingual stance leaving the field of literature related to this subject with a lacking for the adoption of an interlingual attitude. The question is whether metaphor is as extensively far-reaching in its influence among the computer users across the globe as it has been pervasive in its use in computer discourse? This study, through drawing the scholars' attention to the significance of user metaphoric awareness in the receptor communities regarding the recognition of any metaphoric application based upon the notion of transparency or opacity of metaphoric meaning in terms of the user's command of the language in use in computer science, tries to put forth the idea of globalization of metaphoric meaning in computer science and its influence upon the users and at the same time propose some possible alternatives to the computer writers and decision-makers both in global and local levels in order for the user metaphoric awareness being promoted.

    doi:10.2190/tw.43.4.d
  2. Improving Scientific Voice in the Science Communication Center at UT Knoxville
    Abstract

    Many science students believe that scientific writing is most impressive (and most professionally acceptable) when impersonal, dense, complex, and packed with jargon. In particular, they have the idea that legitimate scientific writing must suppress the subjectivity of the human voice. But science students can mature into excellent writers whose voices are clear, interesting, unburdensome, efficient, and accurate. To do this, they must abandon their ponderous scientific voices and use techniques that produce good style. When I teach for the Science Communication Center at the University of Tennessee, Knoxville, I focus on helping students improve their scientific voice. I use workshop-style instruction, review of student writing, tutorial staff, and free online tutorials that I have developed. This article meditates upon the nature of good scientific voice as it analyzes examples of student writing to show improvements made through specific stylistic techniques.

    doi:10.2190/tw.43.4.e

July 2013

  1. The State of Technical Communication in the Former Ussr: A Review of Literature
    Abstract

    Over the last 2 decades, the nations that once comprised the Soviet Union have begun to play an increasingly important role in the global economy. As a result, today's technical and professional communicators could find themselves interacting with co-workers, colleagues, and clients in these nations. Being successful in such contexts, however, requires an understanding of the cultural, historic, educational, and economic factors that have affected and continue to shape technical and professional communication practices in these countries. This article provides an overview of the literature that has been published on technical and professional communication practices in the former USSR as well as reviews educational factors that have contributed to such practices. Through such an examination, the article provides readers with a foundation they can use to engage in future research relating to technical and professional communication practices in post-Soviet states.

    doi:10.2190/tw.43.3.b
  2. Online Social Networking across Cultures: An Exploration of Divergent and Common Practices
    Abstract

    Building on the authors' prior studies that investigate uses and perceptions of online social networks, this study critically explores the emerging social networking culture. In doing so, the research seeks to identify possible constructs that can be used to predict social networking behavior that may then be tested in a future study. The study relies on multiple user perspectives, drawing its participants from international students at two universities, one in Australia and one in the United States. Throughout this process, the utility of using the lens of national culture versus using other lenses is also examined. While the qualitative data suggests somewhat divergent approaches to social networking in different countries, a number of common themes were also identified. Two themes which appeared across national boundaries were changes in use over time and privacy and trust.

    doi:10.2190/tw.43.3.e

April 2013

  1. Sixteenth- and Seventeenth-Century Falconry Manuals: Technical Writing with a Classical Rhetorical Influence
    Abstract

    This study traces Renaissance and post-Renaissance technical writers' use of classical rhetoric in English instruction manuals on the sport of falconry. A study of the period's five prominent falconry manuals written by four authors—George Turberville, Simon Latham, Edmund Bert, and Richard Blome—reveals these technical writers' conscious use of classical rhetoric as an important technique to persuade readers to accept these authors' authority and trust the information they were disseminating. These manuals employed several classical rhetorical techniques: invention by using ethos and several classical topics, classical arrangement, the plain style, and adaptation of the orator's duties. The explanation for this classical influence rests in the authors' own knowledge of classical rhetoric derived from sources such as Thomas Wilson, as well as the sources from whom these authors obtained their knowledge of falconry. The article ends by suggesting the origins through which these classical rhetorical techniques influenced the writing of the manuals.

    doi:10.2190/tw.43.2.c

January 2013

  1. Exposing Hidden Relations: Storytelling, Pedagogy, and the Study of Policy
    Abstract

    Within a Technical Communication classroom, policywork has been used to teach students the vital discursive and conceptual skills valued by technical fields. However, given the move of technical communicators into the public sphere, these skills can and should be expanded to include diverse practices and modes of thought. As such, this article suggests that storytelling can be used as a pedagogical tool to help students think more critically about the (sometimes hidden) relationships that policywork inheres. This article articulates relational work as a target skills set for students and suggests specific activities and handouts for developing these skills.

    doi:10.2190/tw.43.1.d

July 2012

  1. The Development of a Project-Based Collaborative Technical Writing Model Founded on Learner Feedback in a Tertiary Aeronautical Engineering Program
    Abstract

    The present article describes and evaluates collaborative interdisciplinary group projects initiated by content lecturers and an English-as-a-Foreign-Language (EFL) instructor for the purpose of teaching technical writing skills in an aeronautical engineering degree program. The proposed technical writing model is assessed against the results of a learner survey and refined accordingly. The survey showed that learners appreciated the cross-disciplinary collaboration in projects, and it delivered important insights into learning effects and student progress in both language and content matters. The article concludes with a list of recommendations for the implementation of project-based collaborative technical writing instruction, which may support or complement academic writing courses in similar contexts. The proposed model considers the circumstances of students in workload-intensive tertiary settings and synthesizes approaches such as problem-based learning, content-based instruction, task-based language teaching, a guided product approach to collaborative writing, and learner autonomy.

    doi:10.2190/tw.42.3.f
  2. Book Reviews: The Bugaboo Review: A Lighthearted Guide to Exterminating Confusion about Words, Spelling and Grammar
    doi:10.2190/tw.42.3.h

July 2011

  1. Visualizing Banking and Financial Products: A Comparative Study of Chinese and American Practices
    Abstract

    This study examines the visual rhetoric used in Chinese and American promotional business communication. Comparing banking and financial product brochures published in the two countries, the study finds similar as well as different visual strategies. Most importantly, the Chinese samples frequently use visual metaphors, whereas the American samples hardly do. Prompted by this finding, I review relevant literature on visual metaphors and examine their structures and rhetorical functions. In addition, the study suggests that buyer images and cartoon images are used differently in the two countries, whereas product-related images are used similarly. I explore the contextual and cultural roots of these findings and offer suggestions on how to visually communicate with the Chinese audience and other international audiences.

    doi:10.2190/tw.41.3.e
  2. Technical Writing and the Development of the English Paragraph 1473–1700
    Abstract

    What is currently known about the history of the paragraph has relied on the work of the first English and American compositionists, humanists, and philologists of the late nineteenth century. Alexander Bain and his followers defined the requirements for the English paragraph and believed it had not existed prior to the eighteenth century. Their sole focus, on humanist and historical writing, yielded a distorted, if not an incorrect history of the paragraph. This article begins to correct that view, prevalent since 1866, by examining paragraphs of practical works, such as printed how-to books of the early English Renaissance until 1700. The variety and quantity of how-to documents increased with the growth of knowledge, advent of printing, and emergence and expansion of middle-class English readers eager for books written in an accessible, non-Latinate style. When we examine paragraphs from technical books printed as early as 1490, we find paragraphs that exemplify the qualities stipulated by Bain nearly 400 years later. The existence of well defined and formulated paragraphs throughout the English Renaissance and the seventeenth century in a wide variety of technical book—works ignored by literary scholars pursuing the history of English—suggests that the paragraph is clearly indigenous to the English composition, much more so than modern composition theory has acknowledged. This article explores example paragraphs of these first English printed technical works and begins to expand the history of the English paragraph. Further studies of later Middle English paragraphs in incunabula of practical, liturgical, and historical works will likely show the indigenous nature of the paragraph to English composition and allow scholars to see how the formation of the paragraph helped English writers over 500–700 years ago create complete texts.

    doi:10.2190/tw.41.3.b
  3. Practicing “Safe” Technical Communication
    Abstract

    The nuclear power industry is undergoing a renaissance, led by initiatives from the Obama administration and several states. In light of this development and the growing information economy, it is crucial that the public be well-informed, effective, and responsible regarding important technological issues. For this reason, undergraduate education, whether for technical or non-technical majors, must include an awareness of the complexity, ambiguity, and interestedness of the use of technical language and information. This is particularly important in communication involving public discourse and perceptions. I discuss here how I foster such awareness in my junior-level technical writing course for non-majors. We focus on the concept “safe” in relation to radiation and nuclear power. This is done in the overall context of making a recommendation for nuclear power as an energy source for the state of Florida for the next two decades, a realistic and urgent technical communication situation. Students see that standards and even the definitions of crucial terms shift depending on context and social circumstances, and that real-world choices involve trade-offs and balances between advantages and disadvantages.

    doi:10.2190/tw.41.3.c
  4. Autobiographical Writing in the Technical Writing Course
    Abstract

    Professionals in the workplace are rarely asked to write autobiographical essays. Such essays, however, are an excellent tool for helping students explore their growth as professionals. This article explores the use of such essays in a technical writing class.

    doi:10.2190/tw.41.3.g

January 2011

  1. Evaluating Applications for an Informal Approach to Information Design: Readers Respond to Three Articles about Nursing
    Abstract

    Although books in the For Dummies series and other similar series have found commercial success, the approach to information design they use has not received much attention in technical communication journals. This article reports on readers' responses to information presented in the magazine Nursing Made Incredibly Easy! and two other nursing journals. Three groups of readers (two groups of nursing students and one group of nursing faculty members) responded to three articles they read by completing questionnaires and participating in focus groups. Nursing Made Incredibly Easy! was regarded as easy to read and as a good starting point for less-experienced readers, but its tone and style elicited some strong objections as well. The article provides observations and recommendations about using an informal approach to information design.

    doi:10.2190/tw.41.1.d

July 2010

  1. Communicating the Risk of Scientific Research
    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.

    doi:10.2190/tw.40.3.c

April 2010

  1. A Dozen Years after Open Source's 1998 Birth, It's Time for <i>OpenTechComm</i>
    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.

    doi:10.2190/tw.40.2.g

January 2010

  1. Safety Warnings in Tractor Operation Manuals, 1920–1980: Manuals and Warnings Don't Always Work
    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.

    doi:10.2190/tw.40.1.b
  2. The Effects of Integrating On-Going Training for Technical Documentation Teams
    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.

    doi:10.2190/tw.40.1.e

July 2009

  1. The Rhetorical Situations of Web Résumés
    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.

    doi:10.2190/tw.39.3.d

April 2009

  1. Composition Studies, Professional Writing and Empirical Research: A Skeptical View
    Abstract

    This article builds upon the work of Richard Haswell's “NCTE/CCCC's Recent War on Scholarship” by providing an alternative framework for empirical inquiry based on principles of skepticism. It examines the literature relating to empirical research and argues that one of the issues at hand is the perceived link of empirical research to positivism, which clashes with the dominant social constructivist paradigm. It draws upon classical rhetoric and the work of radial empiricist William James to formulate an alternative framework for empirical research based on skeptical principles.

    doi:10.2190/tw.39.2.e

January 2009

  1. Frames in Reports and in Reporting: How Framing Affects Global Warming Information in the Intergovernmental Panel on Climate Change's “Summary for Policymakers” and in Documents Written about the Report
    Abstract

    Although much has been written about the use of rhetoric in technical communication, the framing of technical documents often is overlooked. Framing differs from rhetoric chiefly in that it involves the use of content selection and structure to place information in a particular context. In this article, I will analyze the techniques used to frame a technical report, the Intergovernmental Panel on Climate Change's “Summary for Policymakers,” and compare them to the techniques used to frame corporate news releases and newspaper articles written about the report. This framing analysis shows that writers of technical documents, news releases, and news articles frame their documents chiefly by choosing which facts to include or exclude, and by the positioning of information within the document.

    doi:10.2190/tw.39.1.d
  2. The Public Presentation of a Hybrid Science: Scientific and Technical Communication in “Iraq's Weapons of Mass Destruction: The Assessment of the British Government” (2002)
    Abstract

    A recent British national intelligence-based Assessment (2002) illustrates how one government agency communicated science to serve its policy goals. This article analyzes some of the values that drive science, public policy, and national intelligence, and traces how those values affected the Assessment writers' goals and communication strategies. Through close reading of the Assessment's foreword and first section, this study shows how the writers shaped scientific and technical information to satisfy their disciplines' values and to naturalize their “proper perspective” on the policy case. Further analysis of similar documents will extend current research on scientific rhetoric, multidisciplinary collaborative writing, and public communication.

    doi:10.2190/tw.39.1.b
  3. ARS Dictaminis Perverted: The Personal Solicitation E-Mail as a Genre
    Abstract

    Phishing e-mails deceive individuals into giving out personal information which may then be utilized for identity theft. One particular type, the Personal Solicitation E-mail (PSE) mimics personal letters—modern perversions of ars dictaminis (the classical art of letter writing). In this article, I determine and discuss 19 appeals common to the PSE. These appeals were established first by conducting generative rhetorical analysis, then by volunteer coding, on 170 e-mails collected over a 12-month period. After defining these categories, I show how these letters are excellent twenty-first century teaching tools for pathos-based argumentation, logical appeals, the creation of ethos, and kairos in the development of perceived exigency.

    doi:10.2190/tw.39.1.c

October 2008

  1. Stasis Theory as a Strategy for Workplace Teaming and Decision Making
    Abstract

    Current scholarship tells us that skills in teaming are essential for students and practitioners of professional communication. Writers must be able to cooperate with subject-matter experts and team members to make effective decisions and complete projects. Scholarship also suggests that rapid changes in technology and changes in teaming processes challenge workplace communication and cooperation. Professional writers must be able to use complex software for projects that are often completed by multidisciplinary teams working remotely. Moreover, as technical writers shift from content developers to project managers, our responsibilities now include user-advocacy and supervision, further invigorating the need for successful communication. This article offers a different vision of an ancient heuristic—stasis theory—as a solution for the teaming challenges facing today's professional writers. Stasis theory, used as a generative heuristic rather than an eristic weapon, can help foster teaming and effective decision making in contemporary pedagogical and workplace contexts.

    doi:10.2190/tw.38.4.d

July 2008

  1. Contextualize Technical Writing Assessment to Better Prepare Students for Workplace Writing: Student-Centered Assessment Instruments
    Abstract

    To teach students how to write for the workplace and other professional contexts, technical writing teachers often assign writing tasks that reflect real-life communication contexts, a teaching approach that is grounded in the field's contextualized understanding of genre. This article argues to fully embrace contextualized literacy and better teach workplace writing, technical writing teachers also need to contextualize how they assess student writing. To this end, this article examines some of workplaces' best assessment practices and critically integrates them into an introductory technical writing classroom through a method called student-centered assessment instruments. This method engages students, as workplaces engage employees, in the assessment process to identify local requirements for writing tasks. Aligned with theory and practice, this method is not only an effective classroom assessment method, but becomes an integrated part of students' genre-learning process within and beyond the classroom.

    doi:10.2190/tw.38.3.e

April 2008

  1. Comparing Powerpoint Experts' and University Students' Opinions about Powerpoint Presentations
    Abstract

    Technical communication instructors want to help students, as well as professionals, design effective PowerPoint presentations. Toward this end, I compare the advice of academic and industry experts about effective PowerPoint presentation design to survey responses from university students about slide text, visual elements, animations, and other issues related to PowerPoint presentation design and delivery. Based on this comparison, I suggest some topics, such as PowerPoint's Slide Sorter view, that technical communication instructors and other presentation instructors might address when they cover presentations in their classes or seminars.

    doi:10.2190/tw.38.2.d
  2. Graphics and Ethos in Biomedical Journals
    Abstract

    This article describes a study that examined the tables and figures in articles from a basic research journal, The Journal of Cell Biology, and compared them to tables and figures from an applied medical journal, The New England Journal of Medicine. Comparison of graphics between the two journals shows sharp differences in terms of range of graphics types, visual consistency within and between articles, or use of color. As the articles take into account what is needed by different audiences, the graphics help to build the credibility of the journal. The study also addresses the question of how scientific visuals contribute to the persuasiveness of a writer, looking at how the graphics within an article affect the credibility or ethos of the writer.

    doi:10.2190/tw.38.2.b

January 2008

  1. Darwin's Dilemma: Science in the Public Forum
    Abstract

    This article explores the basis of the public debate between Darwinian evolution and creationism. Using dramatic analysis, we show that the source for the debate is due to what we call “Darwin's Dilemma,” which is found in Darwin's Origin of Species. In the Origin, Darwin extends the mechanistic metaphor featured in Enlightenment science by devising the concept of “natural selection.” In the process, however, he also ascribes a motive to nature, which moves his theory outside the boundaries of Enlightenment science. We show that he is aware of this dilemma in his theory, and that he tries to pass it off as a metaphorical maneuver for the sake of brevity. Darwin's inability to resolve this dilemma, however, opens the door for purveyors of creationism and intelligent design. Indeed, much of the debate today over Darwinian evolution still pivots on our inability to come to terms with Darwin's dilemma.

    doi:10.2190/tw.38.1.d

October 2007

  1. Implementation of Medical Research Findings through Insulin Protocols: Initial Findings from an Ongoing Study of Document Design and Visual Display
    Abstract

    Medical personnel in hospital intensive care units routinely rely on protocols to deliver some types of patient care. These protocol documents are developed by hospital physicians and staff to ensure that standards of care are followed. Thus, the protocol document becomes a de facto standing order, standing in for the physician's judgment in routine situations. This article reports findings from Phase I of an ongoing study exploring how insulin protocols are designed and used in intensive care units to transfer medical research findings into patient care “best practices.” We developed a taxonomy of document design elements and analyzed 29 insulin protocols to determine their use of these elements. We found that 93% of the protocols used tables to communicate procedures for measuring glucose levels and administering insulin. We further found that the protocols did not adhere well to principles for designing instructions and hypothesized that this finding reflected different purposes for instructions (training) and protocols (standardizing practice).

    doi:10.2190/v986-k02v-519t-721j
  2. Seeing Cells: Teaching the Visual/Verbal Rhetoric of Biology
    Abstract

    This pilot study obtained baseline information on verbal and visual rhetorics to teach microscopy techniques to college biology majors. We presented cell images to students in cell biology and biology writing classes and then asked them to identify textual, verbal, and visual cues that support microscopy learning. Survey responses suggest that these students recognized some of the rhetorical strategies used and conflated others, revealing intriguing questions for further research in undergraduate microscopy education.

    doi:10.2190/6261-4915-6lk8-11l8

July 2007

  1. The Relevance of Feenberg's Critical Theory of Technology to Critical Visual Literacy: The Case of Scientific and Technical Illustrations
    Abstract

    Andrew Feenberg's critical theory of technology is an underutilized, relatively unknown resource in technical communication which could be exploited not only for its potential clarification of large social issues that involve our discipline, but also specifically toward the development of a critical theory of illustrations. Applications of critical theory help strengthen our discipline by forcing us to delineate extant approaches and consider whether democratic goals are being achieved through those approaches. If a critical theory of illustrations can be built from Feenberg's critical theory of technology, it should be useful for classroom instructors and researchers as well as theorists.

    doi:10.2190/tw.37.3.b

April 2007

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

    doi:10.2190/382g-91t8-t06r-2l52

January 2007

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

    doi:10.2190/9127-p120-r277-0812

October 2006

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

    doi:10.2190/4480-0652-hl37-77g7

July 2006

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

    doi:10.2190/d86g-ugch-bfx8-10ey
  2. 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.

    doi:10.2190/07ll-2k2m-27kh-cx1w