Journal of Technical Writing and Communication

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

April 2013

  1. Book Reviews: Everyday Genres: Writing Assignments across the Disciplines, Culture, Communication, and Cyberspace. Rethinking Technical Communication for International Environments, Silence and Listening as Rhetorical Arts
    doi:10.2190/tw.43.2.g
  2. Moving towards Ethnorelativism: A Framework for Measuring and Meeting Students' Needs in Cross-Cultural Business and Technical Communication
    Abstract

    Scholars in business and technical communication have continuously made efforts to look for effective teaching approaches for cross-cultural business and technical communication; however, little research has been conducted to study the process by which students develop intercultural competence; fewer studies have been conducted to assess learners' needs for gaining intercultural competence in the globalization age. To assess students' level of intercultural competence and understand whether they are likely to change in response to teaching, I first introduce a two-part framework for teaching and learning intercultural business and technical communication: the DMIS model—Developmental Model of Intercultural Sensitivity, and the related instrument to assess intercultural sensitivity—the Intercultural Development Inventory (IDI). Then I report the results of using the framework to assess and develop students' intercultural competence, and conclude the study by emphasizing the significance of the current empirical research and discuss the framework's limitations.

    doi:10.2190/tw.43.2.f

January 2013

  1. Book Reviews: Storycraft: The Complete Guide to Writing Narrative Nonfiction, Imprint and Trace: Handwriting in the Age of Technology, Teaching Intercultural Rhetoric and Technical Communication: Theories, Curriculum, Pedagogies and Practices
    doi:10.2190/tw.43.1.f
  2. 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

October 2012

  1. Game Theory and Technical Communication: Interpreting the Texas Two-Step through Harsanyi Transformation
    Abstract

    The author uses game theoretical models to identify technical communication breakdowns encountered during the notoriously confusing Texas Two-Step voting and caucusing process. Specifically, the author uses narrative theory and game theory to highlight areas where caucus participants needed instructions to better understand the rules of the game and user analysis to better anticipate participants' motives and strategies. As a central tool of analysis, the author uses Nobel Laureate John C. Harsanyi's work on “incomplete game” or Bayesian games. The article demonstrates opportunities for technical communication scholars and teachers to use interdisciplinary approaches to discover layers of technical communication in small group negotiations and to evaluate the layers of instructions and technologies needed to facilitate effective and ethical decision making in political caucusing.

    doi:10.2190/tw.42.4.c
  2. Immutable Mobiles Revisited: A Framework for Evaluating the Function of Ephemeral Texts in Design Arguments
    Abstract

    This article makes the argument that material evidence for many of the most valuable contributions that contemporary technical communicators make to their organizations is often found not in the traditional documentation that they produce but, rather, in the more fragmentary and provisional documents they create as daily participants in their work teams. To make this argument, the article presents data from a case study of a technical communicator at a software firm, showing how a reminder note he carried to a meeting helped him achieve an important design change. The article unpacks the concept of immutable mobiles from actor network theory to derive a framework that helps us interpret the multiple functions of this note in helping the technical communicator warrant and win a design argument with software developers.

    doi:10.2190/tw.42.4.e
  3. Place Existing Online Business Communication Classes into the International Context: Social Presence from Potential Learners' Perspectives
    Abstract

    Recent scholarship on global online courses points to the need to examine the issue of social context in an online global learning environment. To explore global learners' cultural perspectives on the social climate of an online class, we first review the social presence theory—which can be used to examine the social climate in an online classroom, and explain factors that contribute to learners' social presence. Then we report findings of a survey conducted among a group of Chinese business students and discuss specific aspects of an online business communication class which might contribute to enhancing global learners' sense of social presence in an online environment. We conclude the study by explaining the present study's implications for delivering effective online business and technical communication courses with global learners and recommending strategies for increasing global audiences' social presence in an online class created by the instructor and the online community.

    doi:10.2190/tw.42.4.f
  4. The Accreditation of Hildegard von Bingen as Medieval Female Technical Writer
    Abstract

    Although scholars have acknowledged technical texts written during the Middle-Ages, there is no mention of “technical writer” as a profession except for Geoffrey Chaucer, and historically absent is the accreditation of medieval female writers who pioneered the field of medical-technical communication. In an era dominated by identifiable medieval male technical writers, this article analyzes the medical texts of Hildegard von Bingen, which should be recognized as significant scientific and medical contributions to the field of medical-technical writing. Because the term “technical writing” or “technical writer” did not exist during the Middle Ages, accrediting female medieval scientific and medical writers as technical writers requires the application of modern thought and definition. Primarily known as a mystic and writer of poetry and music, Hildegard's technological and medical texts have slowly gained interest within the medical community. Her texts Physica and Causae Curae, written in the style of modern-day patient history and physicals, outline patient symptoms, causes and effects, preceded by a treatment plan. This article examines Hildegard von Bingen's medical works, identifying her as a scientific or medical technical writer within the same context from which scholars assign Chaucer the same title, and from which all medical and scientific writers of medical texts can be professionally accredited as technical communicator or writer.

    doi:10.2190/tw.42.4.d

July 2012

  1. Taxonomies, Folksonomies, and Semantics: Establishing Functional Meaning in Navigational Structures
    Abstract

    This article argues for the establishment of a usability process that incorporates the study of “words” and “word phrases.” It demonstrates how semantically mapping a navigational taxonomy can help the developers of digital environments establish a more focused sense of functional meaning for the users of their digital designs.

    doi:10.2190/tw.42.3.d
  2. 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
  3. Preparing Technical Communication Students to Function as User Advocates in a Self-Service Society
    Abstract

    The self-service nature of today's society means that technical communicators are needed more than ever before since users may find themselves struggling to make sense of online documentation with minimal support from the institutions that provide it. Certain demographics within the user population (older adults, disabled persons, non-native speakers) may face serious challenges when trying to use self-service documentation. Technical communication educators should prepare students to function as user advocates for members of these groups. Technical communication students need a thorough understanding of the challenges that may interfere with an audience's ability to use websites and other online documentation. This article suggests ways to help students gain this understanding through course content and by structuring service-learning and virtual team projects in which students can put their newly-developed understanding into practice.

    doi:10.2190/tw.42.3.g

April 2012

  1. Bridging the Gap between the Technical Communication Classroom and the Internship: Teaching Social Consciousness and Real-World Writing
    Abstract

    Service-learning projects and traditional internships both prepare the student of technical communication for the workforce in many ways. What is lacking in the scholarship is a discussion of how to successfully link these two ideas. To help teachers implement courses that bridge the gap between service-learning projects and internships, I discuss how to design a course in technical communication that actively prepares students for subsequent internships with nonprofit agencies. In specific, I outline social development and social learning theories, service-learning pedagogies, and lesson plans and assignments that integrate these theories into practice. This project serves as a model that insists that the teacher first instructs students regarding not only rhetorical aspects of document design, including audience awareness and style, but also in placing the students in internships and designing assignments to be fulfilled in internship roles. The combination of classroom practices with an internship supports the idea that students learn the value of the process of writing, including the social embeddedness that can often influence their writing.

    doi:10.2190/tw.42.2.f
  2. Circularity, Analogy, and Gestalt in the Ancestral Puebloan Cannibalism Debate
    Abstract

    This study examines the controversy over alleged cannibalism in the prehistoric American Southwest as it played out in scholarly journals. It also examines the lessons those controversies provide technical communication. Data painstakingly collected from human remains at ancestral Pueblo sites have been interpreted as representing cannibalism and, alternatively, as indicating witchcraft, mutilation of the dead, and warfare. Three focal points of this study are the circular process of developing criteria for analysis in archaeology, the role of analogy in building hypotheses, and the role of gestalt in interpretation of the findings. This study also looks at the ways narratives contribute to knowledge building.

    doi:10.2190/tw.42.2.b
  3. Challenges and Rewards of Teaching Intercultural Communication in a Technical Writing Course: A Case Study
    Abstract

    Community-based projects immerse technical writing students in intercultural communication, addressing local needs and shaping documents in human terms. Students at a South Texas university work to establish communication with clients in a city-county health department to create effective documents and disseminate family health legislation. To prepare students for interactions in multicultural settings, the teacher provides an instructional framework that highlights the concepts and values of intercultural communication and the principles for effective problem-solving. Students engaged in the Baby Moses ( el niño Moisés) project encounter misunderstandings, rhetorical challenges within the process of document creation, and cultural tensions that thwart their goal to disseminate information to the community. Students and the teacher learn that the classroom, like the city-county health department, is a fertile site for cultural disequilibrium, tensions, and potential cultural awareness. To insure a viable Technical and Professional Writing Program in a culturally diverse university and surrounding community, the teacher identifies opportunities that help students develop and enhance their identities as culturally-sensitive communicators and effective problem solvers.

    doi:10.2190/tw.42.2.d
  4. A New Method in User-Centered Design: Collaborative Prototype Design Process (CPDP)
    Abstract

    To build upon user-centered design methods, we used a collaborative and multi-modal approach to involve users early in the design process for a website. This article presents our methods and results and addresses the benefits and limitations of the Collaborative Prototype Design Process (CPDP), including ways in which this new method can be implemented. The CPDP is an innovative approach to user-centered website design that emphasizes collaboration, iterative testing, and data-driven design. The CPDP balances the power and needs of users with those of designers and, thus, enables design teams to test more tasks and involve more users. We divided our initial team into three independent design teams to separately profile users, test usability of low-fidelity paper prototypes, and then create and test usability of resulting wireframes. After completing the user-centered design and usability testing, the three teams merged to analyze their diverse findings and create a final prototype.

    doi:10.2190/tw.42.2.c
  5. Liberating Intercultural Technical Communication from “Large Culture” Ideologies: Constructing Culture Discursively
    Abstract

    Although contemporary writers on culture have argued for more dynamic approaches to culture in intercultural technical communication scholarship, much of the theoretical position on culture is still heavily based on “large culture” ideologies. Yet, not only do these ideologies fail to account for cultural practices and values within less comprehensive groups within culture, but they do not accommodate the inputs individuals make in specific communication contexts. This article draws from the existing body of work and the critical cultural perspectives on culture advocated by contemporary anthropologists and sociologists, mainly Arjun Appadurai (1996), to argue that we construct culture discursively to address cultural issues in intercultural technical communication. A discursive paradigm of culture sees culture as “socially constructed” in which culture is under construction and reconstruction by active cultural actors, who construct their identities and negotiate systems of knowledge and meaning that come to play during intercultural contacts.

    doi:10.2190/tw.42.2.e

January 2012

  1. Hypertext Theory: Rethinking and Reformulating What We Know, Web 2.0
    Abstract

    This article traces the influences of hypertext theory throughout the various genres of online publication in technical communication. It begins with a look back at some of the important concepts and theorists writing about hypertext theory from the post-World War II era, to the early years of the World Wide Web 2.0, and the very differing notions of its potential. A significant challenge during this formative period was the fact that limitations in technology and infrastructure placed limitations on the potential envisioned by these scholars. The ways in which we look at early scholarship differ even a decade or more later, in terms of some of the information technologies and tools we use today. In the Web 2.0 era, we see a trend of blending and extension beyond principles found within hypertext theory in the tools we use and user experiences we create with them.

    doi:10.2190/tw.42.1.d

July 2011

  1. Design and Usability: Beginner Interactions with Complex Software
    Abstract

    The software for a military command and control (C2) system presents an information space in which the C2 operator must manipulate a complex set of information in order to maintain the common tactical picture. A usability test of C2PC, a C2 system currently used by the U.S. Marine Corps, was performed with 13 Marines as participants. They were given problems designed to require actions similar to what they would encounter during real-world Combat Operations Center (COC) operation. The observations revealed an interesting disconnect between the underlying design assumptions and how beginner C2 operators interacted with the system. They were able to perform simple tasks, but could not combine those simple tasks into realistic tasks. These differences highlight the need for using complex scenarios when testing complex systems.

    doi:10.2190/tw.41.3.d
  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. Emphasizing Research (Further) in Undergraduate Technical Communication Curricula: Involving Undergraduate Students with an Academic Journal's Publication and Management
    Abstract

    This article presents follow-up information to a previous publication regarding ways to increase emphasis on research skills in undergraduate Technical Communication curricula. We detail the ways our undergraduate program highlights research by requiring majors to complete senior thesis projects that culminate in submission to an online peer-reviewed journal housed at our institution. This article also describes the roles our undergraduate students play in helping to manage the publication of that academic journal, an activity that further increases students' awareness of the research process and the value of writing for an academic audience beyond the classroom.

    doi:10.2190/tw.41.3.f
  5. 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

April 2011

  1. Meeting Students Where They Are: Advancing a Theory and Practice of Archives in the Classroom
    Abstract

    This article uses theories of technical communication and archives to advance a pedagogy that includes archival production in the technical communication classroom. By developing and maintaining local classroom archives, students directly engage in valuable processes of appraisal, selection, collaboration, and retention. The anticipated outcomes of this work are the critical practice of making connections, the decentering of the self, the ability to work through noise, and the ability to imagine future users of the archive. The authors conclude that local classroom archives are one new means of meaningful instruction in the technical communication classroom and the local archive concept has great potential for further development.

    doi:10.2190/tw.41.2.e
  2. Moving International Technical Communication Forward: A World Englishes Approach
    Abstract

    This article explores how the English language contributes to cross-boundary communication failure and establishes that there is an “English language problem” that has not been adequately addressed in preparing United States native English-speaking students for international technical communication tasks. For example, U.S. technical communication scholars are still grappling with the problems of using English in software internationalization and translating technical communication products across boundaries of national culture and language without privileging Western values and beliefs. The tendency is to assume American culture and American Standard English as the norm, and to identify cultural and linguistic differences as problems only when there is a communication failure or when non-native speakers of English translate product users' manuals and other documents for use by Americans. The article draws attention to the limitations of the current favored strategies for training native speakers in international audience analysis and calls for a revamping of the curriculum to allow for the integration of language-based methodologies. It suggests the incorporation of the World Englishes perspective into training programs to internationalize students' learning experiences.

    doi:10.2190/tw.41.2.b

January 2011

  1. The Technical Communicator as Evangelist: Toward Critical and Rhetorical Literacies of Software Documentation
    Abstract

    In spite of a critical turn in technical communication research, discussions of software documentation continue to forward a singularly instrumental understanding of how these types of texts are composed and consumed. Using work on multiliteracies, I illustrate how analysis of the competing evangelisms of software that occur in programming culture unveils the ways in which documentation, like code, is ideologically encoded. Attention to the evangelisms of software facilitates critical literacy and, consequently, a richer rhetorical literacy. Such literacies are necessary for composing effective software documentation and identifying how the ideologies of software and its documentation intersect with the nationally-situated cultural values in which these technologies and texts are developed and used. To illustrate this complexity, I offer examples of the intersections between free and open source software evangelisms and the national-as-local contexts of the United States, Brazil, and China.

    doi:10.2190/tw.41.4.d
  2. Technical Communications in OSS Content Management Systems: An Academic Institutional Case Study
    Abstract

    Single sourcing through a content management system (CMS) is altering technical communication practices in many organizations, including institutions of higher education. Open source software (OSS) solutions are currently among the most popular content management platforms adopted by colleges and universities in the United States and abroad. The GPL license, ease of use, customizability, and the large, global user base of mature content management systems are among the reasons these organizations choose OSS to meet their CMS needs. This article reviews the literature on the effects of single sourcing on technical communication practice. It also explores issues of OSS adoption, both generally and in international contexts. Through a case study of an OSS CMS implementation at a mid-sized public college, the article examines important contributions technical communicators can make to the rollout of an OSS-based CMS.

    doi:10.2190/tw.41.4.f
  3. Journal of Technical Writing and Communication: Index-Contents of Volume 41, 2011
    doi:10.2190/tw.41.4.h
  4. Open Source Communities in Technical Writing: Local Exigence, Global Extensibility
    Abstract

    By offering open-source software (OSS)-based networks as an affordable technology alternative, we partnered with a nonprofit community organization. In this article, we narrate the client-based experiences of this partnership, highlighting the ways in which OSS and open-source culture (OSC) transformed our students’ and our own expectations of traditional hierarchies\nin technical writing classes and work. The integration of OSS into technical communication classes shifted our work toward distributed symbolic-analytic issues and practices. Specifically, our engagements with OSS/OSC increased student awareness of the political and cultural significance of OSS and proprietary technology systems, and flattened traditional educational and client-student hierarchies. In this way, OSS/OSC offers ways to attune local pedagogy and practice to global developments in technical writing, and provide today’s technical communication students with the experiences needed to succeed in the workplace of tomorrow.

    doi:10.2190/tw.41.4.e
  5. Open Source Software Peer-To-Peer Forums and Culture: A Preliminary Investigation of Global Participation in User Assistance
    Abstract

    This article initiates a discussion about the global impact of peer-to-peer (P2P) user-assistance strategies and mechanisms and looks specifically at the forums for open source software (OSS) systems. Through a brief study of the interactions among international users of the forum, this article presents ideas on how commercial organizations and technical communicators can become valuable members of these new communities that are gaining prominence in global use.

    doi:10.2190/tw.41.4.c
  6. 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

October 2010

  1. Resisting the Lure of Technology-Driven Design: Pedagogical Approaches to Visual Communication
    Abstract

    Technical communicators are expected to work extensively with visual texts in workplaces. Fortunately, most academic curricula include courses in which the skills necessary for such tasks are introduced and sometimes developed in depth. We identify a tension between a focus on technological skill vs. a focus on principles and theory, arguing that we subvert the potential benefits of an education if we succumb to the allure of software. We recommend several classroom practices that help educate students toward greater visual literacy, based not only on recommendations from the research but also from our experience as teachers of visual communication.

    doi:10.2190/tw.40.4.f
  2. Interpretive Discourse and other Models from Communication Studies: Expanding the Values of Technical Communication
    Abstract

    This article argues that in spite of some attempts to expand the diversity of approaches in Technical Communication, the field remains rooted in an expedient, managerial, techno-rational discourse, where discourse is understood as the values that guide research, practice, and teaching. The article draws on approaches from Communication Studies, specifically discursive analysis and metaphor analysis, to ground this claim and to demonstrate what possible alternative discourses might be possible. The article then argues that moving toward an “interpretive” discourse will expand the values of Technical Communication, but in a way that both retains existing assumptions but also includes a new focus on the “complete person.” Interpretive discourse is theorized using Habermas' communicative rationality and User Experience Design and the article concludes with some implications about moving Technical Communication toward discursive diversity. Ultimately, the goal of the article is to encourage researchers, teachers, and professionals to embrace this discursive diversity that complicates our historical means-ends rationality.

    doi:10.2190/tw.40.4.d
  3. 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.

    doi:10.2190/tw.40.4.b

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
  2. The Banality of Rhetoric? (Part 2): Alternate Views of Technical Communication and the Holocaust
    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.

    doi:10.2190/tw.40.3.e
  3. The Children of Aramis
    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.

    doi:10.2190/tw.40.3.b
  4. 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.

    doi:10.2190/tw.40.3.f

April 2010

  1. Relationship between Innovation and Professional Communication in the “Creative” Economy
    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.

    doi:10.2190/tw.40.2.b
  2. A Dozen Years after Open Source's 1998 Birth, It's Time for OpenTechComm
    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
  3. 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.

    doi:10.2190/tw.40.2.d
  4. Book Reviews: Technical Writing: A Guide for Effective Communication, Network: Theorizing Knowledge Work in Telecommunications, beyond the Archives: Research as Lived Process
    doi:10.2190/tw.40.2.h

January 2010

  1. Book Reviews: Professional Communication in Engineering, the Internet Imaginaire, Content Management: Bridging the Gap between Theory and Practice, Outsourcing Technical Communication: Issues, Policies and Practices, Questioning Library Neutrality: Essays from Progressive Librarian
    doi:10.2190/tw.40.1.f
  2. 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.

    doi:10.2190/tw.40.1.d
  3. 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

October 2009

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

    doi:10.2190/tw.39.4.f

July 2009

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

    doi:10.2190/tw.39.3.f
  2. 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
    doi:10.2190/tw.39.3.h

April 2009

  1. The Banality of Rhetoric? Assessing Steven Katz's “the Ethic of Expediency” against Current Scholarship on the Holocaust
    Abstract

    Since 1992, Steven Katz's “The Ethic of Expediency” on the rhetoric of technical communication during the Holocaust has become a reference point for discussions of ethics. But how does his thesis compare to current understandings of the Holocaust? As this article describes, Katz was in step with the trend two decades ago to universalize the lessons of the genocide but his thesis presents key problems for Holocaust scholars today. Against his assertion that pure technological expediency was the ethos of Nazi Germany, current scholarship emphasizes the role of ideology. Does that invalidate his thesis? Katz's analysis of rhetoric and his universalizing application to the Holocaust are two claims that may be considered separately. Yet even if one does not agree that “expediency” is inherent in Western rhetoric, Katz has raised awareness that phronesis is socially constructed so that rhetoric can be unethically employed. Thus, rather than remain an uncritically accepted heuristic for technical communicators, “The Ethic of Expediency” can be a starting point for ongoing exploration into the ethical and rhetorical dimensions of the genre.

    doi:10.2190/tw.39.2.f

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. Book Reviews: Resources in Technical Communication: Outcomes and Approaches, Letting Go of the Words: Writing Web Content That Works
    doi:10.2190/tw.39.1.g