Journal of Technical Writing and Communication

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

January 2009

  1. Oral Communication and Technical Writing: A Reconsideration of Writing in a Multicultural Era
    Abstract

    This article investigates the status of orality in the history of technical communication. The article calls for orality as an integral part and driving force of technical writing. The article brings to light the misconceptions that have led to a diminished role of oral communication in technical writing. The article shows the implications of oral skills for improved effectiveness of technical communicators. The article outlines the challenges and promises of teaching oral communication in technical writing.

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

October 2008

  1. Teaching Intercultural Communication in a Basic Technical Writing Course: A Survey of Our Current Practices and Methods
    Abstract

    This research article reports the results of an online survey distributed among technical writing instructors in 2006. The survey aimed to examine how we teach intercultural communication in basic technical writing courses: our current practices and methods. The article discusses three major challenges that instructors may face when teaching about intercultural communication. These challenges concern teacher preparation, time and proposed goals and objectives, and teaching materials and methods. This article provides some suggestions for addressing the challenges and enriching a technical writing curriculum.

    doi:10.2190/tw.38.4.e
  2. Police Reform, Task Force Rhetoric, and Traces of Dissent: Rethinking Consensus-as-Outcome in Collaborative Writing Situations
    Abstract

    Pedagogical and scholarly representations of collaborative writing and knowledge construction in technical communication have traditionally recognized consensus as the logical outcome of collaborative work, even as scholars and teachers have acknowledged the value of conflict and “dissensus” in the process of collaborative knowledge building. However, the conflict-laden work product of a Denver task force charged with recommending changes to the city police department's use-of-force policy and proposing a process for police oversight retains the collaborative group's dissensus and in doing so, illustrates an alternative method of collaborative reporting that challenges convention. Such an approach demonstrates a dissensus-based method of reporting that has the potential to open new rhetorical spaces for collaborative stakeholders by gainfully extending collaborative conversations and creating new opportunities for ethos development, thus offering scholars, teachers, and practitioners a way of reimagining the trajectory and outcome of collaborative work.

    doi:10.2190/tw.38.4.c

July 2008

  1. Cruel Theory? The Struggle for Prestige and its Consequences in Academic Technical Communication
    Abstract

    Some struggles for prestige in academic technical communication are self-defeating and wasteful because of the clash between the material (or positive-sum) economy of the workplace and the positional (or zero-sum) economy of the academy. Some professors of technical communication create disrespect for themselves and their specialities because they create degrading representations of working people and their artifacts, they promote impossible standards, and they advance discredited or misleading theories. More profitable approaches to gaining prestige for academic technical communication include recognizing that not everyone can be the top person in the positional economy, studying works on the economics of prestige, and promoting the genuinely good works that already exist in academic technical communication.

    doi:10.2190/tw.38.3.c
  2. 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. Toward a Critical Perspective of Culture: Contrast or Compare Rhetorics
    Abstract

    Kaplan's framework of contrastive rhetoric has been widely accepted in the field of cross-cultural technical communication. However, in the last four decades, contextual factors such as economic globalization trend and the advances of communication technologies are changing our ways of interacting with others. As a result our understanding of culture and cultural differences need to be adjusted. In this research, I start by recommending a workable definition of culture in the present context—culture as a process, which establishes a foundation for cross-cultural rhetorical research in the new era when communication across cultures transcends national boundaries. Based on the critical perspective of culture, I continue to point out the limitations of contrastive rhetoric and argue that contrastive rhetoric's view of culture and its research purpose and methodology need to be modified to overcome its constraints and better meet the needs of the present social context.

    doi:10.2190/tw.38.2.c
  2. 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

January 2008

  1. Technical Writing in English Renaissance Shipwrightery: Breaching the Shoals of Orality
    Abstract

    Describing the emergence of the first shipbuilding texts, particularly those in English provides another chapter in the story of the emergence of English technical writing. Shipwrightery texts did not appear in English until the middle decades of the seventeenth century because shipwrightery was a closed discourse community which shared knowledge via oral transmission. The shift from orality to textuality in shipwrightery did not occur until advancing navigation principles enabled ships to sail in open waters. Shipping rapidly became a commercial business, and shipwrightery was forced to move from closely-guarded simple design principles to mathematically-based designs too complex to be retained only in memory of shipwrights and shared via oral transmission. Textual transmission began to supplant oral instruction. The evolution of English shipwrightery provides rich research opportunities for historians tracking the development of technical writing.

    doi:10.2190/tw.38.1.b

October 2007

  1. Multimodal Analysis: An Integrative Approach for Scientific Visualizing on the Web
    Abstract

    The Multimodal approach offers technical communicators and science writers an analytical tool to synthesize the meaning made in the connections across communicative modes. This multimodal synthesis can help technical communicators better exploit the meaning-making potential of multimodal combinations and understand the needs of future generations shaped by their increasingly developed multimodal literacy.

    doi:10.2190/d38r-52p1-8t72-1375

July 2007

  1. The Steel Bible: A Case Study of 20th Century Technical Communication
    Abstract

    The “steel bible” emerged in 1919 and went through 11 editions in 80 years. In its evolution we can see the shift from individual to group authorship, an increasing use of visual elements, and a physical change from a small, hand-held volume to a weighty desktop reference. In a textual analysis, we can see that it was essentially static, changing only by additions and deletions, as the industry evolved. The eventual closing of hundreds of plants and the migration of the industry to other countries can be seen in the change of publisher, the sudden absence of photography, and the international references. Originally, the steel bible came from the factory floor and the words of the plant managers, but by the 1990s, it was a highly-abstracted representation of knowledge. In the steel bible, we can see the history of the industry and the maturing of technical communication in the 20th century.

    doi:10.2190/tw.37.3.d
  2. Content Analysis as a Best Practice in Technical Communication Research
    Abstract

    Content analysis is a powerful empirical method for analyzing text, a method that technical communicators can use on the job and in their research. Content analysis can expose hidden connections among concepts, reveal relationships among ideas that initially seem unconnected, and inform the decision-making processes associated with many technical communication practices. In this article, we explain the basics of content analysis methodology and dispel common misconceptions, report on a content analysis case study, reveal the most important objectives associated with conducting high quality content analyses, and summarize the implications of content analysis as a tool for technical communicators and researchers.

    doi:10.2190/tw.37.3.c
  3. Training Teachers and Serving Students: Applying Usability Testing in Writing Programs
    Abstract

    Teachers often test course materials by using them in class. Usability testing provides an alternative: teachers receive student feedback and revise materials before teaching a class. Case studies based on interviews and observations with two teaching assistants who usability tested materials before teaching introductory technical writing demonstrate how usability testing can make novice teachers more confident about and help them predict student experiences with their assignments. By helping to train teachers, usability testing can also help better serve students.

    doi:10.2190/tw.37.3.f
  4. 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. The Intercultural Component in Textbooks for Teaching a Service Technical Writing Course
    Abstract

    This research article investigates new developments in the representation of the intercultural component in textbooks for a service technical writing course. Through textual analysis, using quantitative and qualitative techniques, I report discourse analysis of 15 technical writing textbooks published during 1993–2006. The theoretical and practical elements of intercultural teaching have been expanded in recent years, but this progress is quite slow. This article provides some directions in which the textbooks can be revised. Such an analysis may be of interest to textbook writers and educators.

    doi:10.2190/85j8-2p74-1378-2188
  2. Crossing National and Corporate Cultures: Stages in Localizing a Pre-Production Meeting Report
    Abstract

    Localization includes translating, explaining, and adapting a document for use in a specific culture. This article presents the case of a form for reporting the findings and decisions of pre-production meetings held during development of electronic products. The need to localize such a document may seem less obvious or critical than the need for sales documents like manuals, but this case demonstrates the same cultural requirements and, furthermore, the requirements of corporate differences. To meet local needs, the comprehensive preparation that localization requires should follow specific methods in each step of a process corresponding to the general writing process, like the stages defined in common technical writing texts. The deliberate use of an effective writing process to localize documents will improve results.

    doi:10.2190/2780-1r37-4w67-38k7
  3. Two Centuries of Progress in Technical Communication
    Abstract

    A common aphorism in the halls of education is that the writing skills of Americans decline over time. Compared to the “golden age of letters,” so the argument goes, each subsequent generation of writers is worse than the last. Although contemporary readers and educators commiserate over encounters with bad writing, a fair comparison of 18th century American exemplars to modern American exemplars reveals a significant advance in clarity, an advance that technical communicators can be proud of. To demonstrate the advances in expository writing over the past two centuries, the author compares what the authors of the U.S. Constitution did with their limited resources to what modern professional communicators do with their abundance of resources. Many of the communication problems that were pervasive when the U.S. Constitution was created have since been remedied by insights emerging from the fields of linguistics, human factors, and cognitive psychology, among others.

    doi:10.2190/y2t7-4672-8u65-u85t
  4. 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. Non-Rule Environmental Policy: A Case Study of a Foundry Sand Land Disposal NPD
    Abstract

    This historical case study of a non-rule policy document (NPD) adopted by the Indiana Department of Environmental Management describes an emerging genre in environmental discourse. The NPD standardizes environmental public policy for land disposal of foundry sand, a solid waste. The collaborative writing process took six months with industry input, and the NPD was presented to two environmental boards. Two contrasts, in process and format, distinguish NPDs from rules. The NPD is an entirely new kind of writing which includes guidance for implementing statutes. The writing process in the case involves government writers and industry representatives, although it does not include other public input such as public hearings. Instead, the staff of the pollution control agency simply presents the NPD to the appropriate environmental policy boards and arranges for its publication. This article adds to the body of knowledge about technical writing in government, specifically environmental policy and non-academic genres.

    doi:10.2190/rr86-5612-8l7t-4h70
  2. 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. A Decade of Research: Assessing Change in the Technical Communication Classroom Using Online Portfolios
    Abstract

    Over a period of 10 years, we have developed a sustainable process of online portfolio assessment that demonstrates both reliability and validity, using both qualitative and quantitative measures. The sustainable cycle is that, each semester, we assess a random sampling of the students' work that they have posted, as per our instructions, in an online portfolio. During the reading, the faculty score the documents for 11 variables, including writing, content, audience awareness, and document design. We achieved validity by a modified online Delphi that led to a redefinition of the construct of technical communication itself; we achieved reliability by adjudication resulting in adjacent scores. The results of our assessment meet the requirements of ABET and result in a continual cycle of improvement for our technical communication curriculum. Results from three semesters show an improving correlation between the course grade and the overall, holistic portfolio score.

    doi:10.2190/c481-k214-8472-n377
  2. 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. The Two Shuttle Accident Reports: Context and Culture in Technical Communication
    doi:10.2190/0a9h-wn06-bqe2-w1ex
  3. 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
  4. To Slideware or Not to Slideware: Students' Experiences with Powerpoint Vs. Lecture
    Abstract

    This study analyzes the performance and attitudes of technical writing students in PowerPoint-enhanced and in non- PowerPoint lectures. Four classes of upper-level undergraduates ( n = 84) at a mid-sized, Southern university taking a one-semester technical writing course were surveyed at the beginning and end of the course about their perceptions of PowerPoint. Of the four sections, two classes were instructed using traditional lecture materials (teacher at podium, chalkboard, handouts); the other two sections were instructed with PowerPoint presentations. All four classes were given the same pre- and post-test to measure performance over the course of the semester. Traditional lecture or PowerPoint presentations consisted of at least 50% of the course, with the remaining time spent on exercises and small group work. Results reveal that while most students say they preferred PowerPoint, performance scores were higher in the sections with the traditional lecture format.

    doi:10.2190/03gx-f1hw-vw5m-7dar

April 2006

  1. Legitimizing Technical Communication in English Departments: Carolyn Miller's “Humanistic Rationale for Technical Writing”
    Abstract

    Carolyn Miller's oft-cited “Humanistic Rationale for Technical Writing,” published in 1979, tries to give technical communication faculty more cultural capital in English departments controlled by literature professors. Miller replaces a positivistic emphasis in technical communication pedagogy with rhetoric. She shows how technical knowledge is produced by individual activity and social affirmation and not by objective descriptions of sensory impressions. Her “Rationale” is an attempt to change institutional and discursive structures by persuading literature professors that technical communication can have as much distinction in the academy as literature.

    doi:10.2190/e1w4-wbxn-htnc-u7ed
  2. Women and Feminism in Technical Communication—An Update
    Abstract

    The purposes of this study are to determine the current status of scholarship published in five major technical communication journals about women and feminism and to identify changes in focus that may have occurred over the last five years. We begin with a discussion of the frequency of publication for articles whose titles have keywords relating to women and feminism. After identifying 21 articles, we consider the thematic patterns in the narrowed corpus. We conclude that scholarly publication about women and feminism in technical communication has moved from a moderate or radical concern for inclusion to a postmodern concern for critique of visual, verbal, and mechanical “technologies,” which previously were not considered political.

    doi:10.2190/4juc-8rac-73h6-n57u
  3. Charles Morris's Semiotic Model and Analytical Studies of Visual and Verbal Representations in Technical Communication
    Abstract

    In this article, the author demonstrates that the semiotic model proposed by Charles Morris enables us to optimize our understanding of technical communication practices and provides a good point of inquiry. To illustrate this point, the author exemplifies the semiotic approaches by scholars in technical communication and elaborates Morris's model through analyzing visual and verbal elements of technical communication brochures from semantic, syntactic, and pragmatic levels. The discussion of semiotic approach reinforced by various examples illustrates that the semiotic model can be a tangible theoretical and practical tool to help students and practitioners study and analyze the use of visual and verbal elements in technical communication.

    doi:10.2190/b8xb-vy4r-r792-dqjg
  4. Tracing W. E. B. DuBois' “Color Line” in Government Regulations
    Abstract

    In this article, I present findings from a discourse analysis of an often-overlooked genre of technical communication, regulatory writing. The study focuses on post-bellum regulations that disproportionately affected African Americans and the historical contexts in which the regulations were written. Historically, African Americans of all socioeconomic backgrounds have maintained an implicit mistrust of government regulations and the government officials who write them. The justification for this mistrust is deeply rooted in the fact that for decades regulations were not written to protect the rights of African Americans nor was their input considered in regulatory writing. In Communicating Across Cultures, Stella Ting-Toomey argues, “if conflict parties do not trust each other, they tend to move away (cognitively, affectively and physically) from each other rather than struggle side by side in negotiation” [1, p. 222]. This study reveals rhetorical strategies used in historical regulatory writing that may still impact the ethos of regulatory writers.

    doi:10.2190/67rn-uawg-4nff-5hl5

January 2006

  1. Aligning Theme and Information Structure to Improve the Readability of Technical Writing
    Abstract

    The readability of technical writing, and technical manuals in particular, especially for second language readers, can be noticeably improved by pairing Theme with Given and Rheme with New. This allows for faster processing of text and easier access to the “method of development” of the text. Typical Theme-Rheme patterns are described, and the notion of the “point of a text” is introduced. These concepts are applied to technical writing and the reader is then invited to evaluate the improvements in readability in a small sample of texts.

    doi:10.2190/37dd-kk2v-0bk5-31em
  2. Guest Editorial: A Response to Patrick Moore's “Questioning the Motives of Technical Communication and Rhetoric: Steven Katz's ‘Ethic of Expediency’”
    Abstract

    In my 1992 College English article “The Ethic of Expediency: Classical Rhetoric, Technology, and the Holocaust” [1], I looked at the implications of a Nazi memo whose sole purpose was to improve the efficiency of the gassing vans, in order to begin to try to understand and discuss the negative uses and ethical abuses to which technical communication, and deliberative rhetoric generally, could be taken by the powerful and unscrupulous. In “Questioning the Motives of Technical Communication and Rhetoric: Steven Katz's ‘Ethic of Expediency’” [2], Patrick Moore accuses me of ignoring alternate translations, citing out of context, and focusing on the negative meaning of words to make my case. The point at issue in these charges, I believe, is whether (and to what degree) Aristotle meant to base deliberative discourse on “expediency.” I will take each of these charges up one at a time to explore them more thoroughly, discuss their interrelations, and then conclude with a few observations of my own.

    doi:10.2190/38d7-8kcx-blaw-y2k5
  3. International Consumer Protection: Writing Adequate Instructions for Global Audiences
    Abstract

    In 2003, the United States exported nearly $720 billion in goods. Businesses that trade in the global market have a legal and ethical duty to make their products reasonably safe, and technical communicators who write the documentation for those products have a legal and ethical duty to protect international consumers by writing adequate instructions. Writing documentation for products that will be distributed internationally requires not only the ability to communicate clearly, but also awareness of the relevant product liability laws, the cultural variables, and the expectations of international audiences. This article first argues that devoting company resources to produce adequate instructions for international users is both practical and ethical, then provides a brief overview of the consumer protection measures that the top U.S. trade partners have implemented, and finally presents guidelines for developing adequate instructions for international audiences.

    doi:10.2190/88t5-8mfh-8ma6-qval

July 2005

  1. Noteworthy Observations about Note-Taking by Professionals
    Abstract

    In this article we focus on professional readers who have to write recommendations in an online environment. We address the question whether taking notes on screen influences the reading process and the quality of the recommendations in terms of applicability, completeness, and persuasiveness. Seven participants each composed two pieces of advice on technical communication issues. They could use an electronic Notepad whenever they wished. Taking notes appeared to influence advice quality negatively, which may be caused by attention shifts from reading to taking notes on screen. Although we could not find a relationship between the contents of the notes and advice quality, we noted differences in note-taking approaches between the participants.

    doi:10.2190/pqyn-ndh6-tu6l-rebc
  2. How to Use Five Letterforms to Gauge a Typeface's Personality: A Research-Driven Method
    Abstract

    Technical communicators need to select typefaces that match the tone that they intend for a document. Rather than relying on intuition or personal preference, technical communicators can use a research-driven approach to analyze objectively the extent to which a typeface's personality meshes with the intended tone of a document. This study describes how technical communicators can analyze a typeface's uppercase J and its lowercase a, g, e, and n letterforms—letterforms that are dense with anatomical information—to gauge the extent to which a typeface will contribute a friendly or a professional personality to a document. Technical communicators—both professionals and students—who are armed with this knowledge can move beyond “safe” typefaces like Times New Roman and Helvetica, selecting instead typefaces whose anatomical features generate different kinds of personalities.

    doi:10.2190/lqvl-ej9y-1lrx-7c95
  3. Illustration and Language in Technical Communication
    Abstract

    Many technical documents present information both graphically and verbally. While much is known about the verbal tools of technical professionals, technical graphics have been less fully examined. Here the drawings of a United States patent are examined revealing a system for organizing and presenting visual information that is analogous to commonly-used models for organizing and presenting verbal information.

    doi:10.2190/hy3l-wn98-qc5r-p3b3

April 2005

  1. An Online Approach to Teaching International Outsourcing in Technical Communication Classes
    Abstract

    The growth of international online access has given rise to a new production method—international outsourcing—that has important implications for technical communication practices. Successful interactions within international outsourcing require individuals to understand how cultural factors could affect online interactions. Today's technical communication students therefore need to understand how factors of culture and media could affect the success with which they operate in international outsourcing activities. This article provides technical communication instructors with a series of Web-based exercises they can use to familiarize students with different aspects that can affect intercultural online interactions. It also provides a series of online resources students can use to enhance their understanding of cross-cultural communication in cyberspace.

    doi:10.2190/h7mp-gjjh-1mhg-kph6
  2. Evaluating the Effect of Iconic Linkage on the Usability of Software User Guides
    Abstract

    This study investigates whether Iconic Linkage—the use of the identical wording to present the same information recurring in a text—can improve the usability of user guides. Iconic Linkage is a writing strategy that potentially allows users to work more quickly and effectively and which promotes better retention of information. The usefulness of Iconic Linkage was tested in a laboratory-based usability study that combined: 1) objective task-based evaluation; and 2) users' subjective evaluations of a software program used in recording parliamentary debates. A post-test survey designed to test subjects' retention of information contained in the user guides was also administered. The study shows that Iconic Linkage significantly improved usability of the user guide: in all tasks, subjects worked more effectively and made fewer mistakes; while in the three timed tasks, subjects completed the tasks much more quickly. Subjects also gave higher ratings for the software and their retention of information was noticeably improved.

    doi:10.2190/uuql-xbrf-ukl6-mrgy
  3. Perceptions of Memo Quality: A Case Study of Engineering Practitioners, Professors, and Students
    Abstract

    One goal of college technical writing courses is to prepare students for real-world writing situations. Business writing textbooks function similarly, using guidelines, sample assignments, and model documents to help students develop rhetorical strategies to use in the workplace. Students attend class, or read and perform exercises in a textbook, with the faith that these skills will apply to workplace writing. In an attempt to better understand the similarities and differences between industry and academe's expectations of one genre of workplace writing, the memo, we compared the perceptions of memo quality by engineering faculty, students, and practitioners. All three groups responded to three sample memos taken from textbooks used by engineering professors in their undergraduate classrooms. The results indicate that students' and engineers' opinions of memo quality were more closely related to one another than to professors' comments, focusing on content, while professors were the most critical of style issues.

    doi:10.2190/ml5n-eyg1-t3f7-rer6

January 2005

  1. Using the Internet as a Tool for Public Service: Creating a Community History Web Site
    Abstract

    Creating a community history Web site is a way for technical communication practitioners, students, and teachers to improve their expertise while performing a valuable public service. Developers of this kind of Web site combine personal interest in the history and culture of their chosen communities with professional interest in a wide range of skills: for example, online research, Web site design, creation of artwork, photography, graphics editing, collaboration, professional/technical writing, as well as site publication and promotion. Technical communicators working on community history Web sites enjoy creative freedom that makes these projects especially engaging and fun. While learning about subjects of particular interest and improving professional skills, developers gain the satisfaction of trying to help communities increase civic pride and heritage tourism. Also, the technical communication profession benefits when its members demonstrate good citizenship to employers, other constituencies, and the public.

    doi:10.2190/kaw0-nqgt-0175-pt7e
  2. A Syntactic Approach to Readability
    Abstract

    Focusing on the issue of readability, this article examines problems that readability formulas present to the technical communicator, especially in terms of interaction with government agencies, and focuses on readability formula requirements mandated by The Office of Health and Industry programs [OHIP] for medical technology product support literature. Because the Flesch Reading Ease and the Flesch-Kincaid formulas are widely available, they are probably the ones most frequently used. Contemporary readability scholars have overlooked the Golub Syntactic Density Formula, which evaluates prose according to a sentence's syntax at a deeper level than the number of words per sentence and the number of syllables per word. The authors recommend it as a tool for evaluating readability. How it might be applied with current computer applications is discussed.

    doi:10.2190/phuc-gy8l-jrle-vmnn
  3. Teaching Technical Writing through Student Peer-Evaluation
    Abstract

    Individual students in two different sections of an undergraduate civil engineering laboratory were tasked with preparing three professional-quality laboratory reports. The teaching assistant and/or instructor used established criteria to grade the first two reports prepared by students in one section. The first two reports prepared by students in the other section were peer evaluated by assigned fellow students within the same laboratory section using identical grading criteria. The peer evaluated section had a higher class average than the teaching assistant/instructor graded section on the fist two reports. The third report prepared by students from both sections was graded by a professional educator/architect without knowledge of a student's class section. The peer evaluation students also had a higher class average on the third report, suggesting that the peer evaluation process may have positively contributed to those students' writing skills.

    doi:10.2190/mbyg-ak7l-5ct7-54du
  4. Visual Metonymy and Synecdoche: Rhetoric for Stage-Setting Images
    Abstract

    The recent trend of incorporating more visuals into communication challenges technical communicators, who must now possess both verbal and visual literacy. Despite all the recent scholarship on visual aspects of technical communication, technical communicators lack thorough guidelines for selecting and composing effective images that convey thematic and conceptual information, or what Schriver calls “stage-setting” images. This article reviews existing literature in visual communication and reports results of a study that assessed readers' opinions of themes conveyed by specific example images. It then suggests that the rhetorical tropes of metonymy and synecdoche can be used to identify images for conveying certain themes, and that successful stage-setting images will show intrinsic, not extrinsic, relationships to their thematic subject matter.

    doi:10.2190/p22x-gka9-7fgt-mt2x

October 2004

  1. Book Reviews: Writing Selves/Writing Societies: Research from Activity Perspectives, a Synoptic History of Classical Rhetoric, Information Design
    doi:10.2190/9vuh-pwk8-gnc2-rl0b
  2. Increasing User Acceptance of Technical Information in Cross-Cultural Communication
    Abstract

    A significant problem in technical communication is persuading the user that the information is accurate, valid, and useful. All too often, technical communicators treat users as members of their own culture. When authors do consider cultural issues, they often focus on matters such as vocabulary, visuals, and organization. Other strategies, however, can be useful in gaining acceptance of technical information in cross-cultural situations. For example, the communication theory of compliance-gaining offers suggestions for how the technical communicators can adapt the text to enhance user acceptance when communicating to members of their own culture as well as when communicating across cultures. Communicators can use promises, threats, demonstrate positive and negative outcomes, extend friendliness, etc., to develop the text. In this article, I will explain several compliance-gaining strategies authors can use, identify rhetorical strategies they can combine with compliance-gaining strategies, show how these strategies can be effective in a cross-cultural environment by comparing the strategies in two sample cultures, and analyze a brief sample.

    doi:10.2190/qrql-v8cq-q8wd-lbwc
  3. Herbert Spencer's Philosophy of Style: Conserving Mental Energy
    Abstract

    My article traces the development, chronicles the impact, and explains the essence of Herbert Spencer's “The Philosophy of Style” (1852). Spencer's essay has had a significant influence on stylistics, especially in scientific and technical communication. Although in our generation Spencer's contribution to stylistics is not widely remembered, it ought to be. His single essay on this subject was seminal to modern theories about effective communication, not because it introduced new knowledge but because it was such a rhetorically astute synthesis of stylistic lore, designed to connect traditional rhetorical theory with 19th-century ideas about science, technology, and evolution. It was also influential because it was part of Spencer's grand “synthetic philosophy,” a prodigious body of books and essays that made him one of the most prominent thinkers of his time. Spencer's “Philosophy of Style” carried the day, and many following decades, with its description of the human mind as a symbol-processing machine, with its description of cognitive and affective dimensions of communication, and with its scientifically considered distillation of the fundamental components of effective style. We should read Spencer's essay and understand its impact not so much because we expect it to teach us new things about good style, but precisely because: 1) it's at the root of some very important concepts now familiar to us; 2) it synthesizes these concepts so impressively; 3) we can use it heuristically as we continue thinking about style; and 4) it provides a compact, accessible touchstone for exploring—with students, clients, and colleagues—the techniques of effective style for scientific and technical communication.

    doi:10.2190/d7g5-dkeu-y8a4-uvwu

July 2004

  1. Sex Differences in Technical Communication: A Perspective from Social Role Theory
    Abstract

    This article interprets technical communication research about sex differences according to social role theory, which argues that sex differences are enculturated through experiences associated with social positions in the family and the workplace. It reevaluates technical communication research about sex differences in communicative and collaborative styles in the classroom and the workplace and about the effects of the double bind that women experience in the workplace. The article concludes with a recommendation that theoretical frameworks explaining sex differences remain flexible and able to account for social change.

    doi:10.2190/px6l-n9c7-0eag-ya2x

January 2004

  1. The Million Dollar Letter: Some Hints on How to Write One
    Abstract

    This article suggests ways of writing a truly effective cover letter, an extremely important document in the search for a job. First, features gleaned from 13 model letters in technical writing textbooks yield figures on the number of words, sentences, and paragraphs per letter, plus the average number of words per sentence and paragraph, information helpful to those with little or no knowledge of how to write a strong cover letter. Second, the article surveys what the textbook writers offer as advice about the rhetorical principles that should be employed in composing cover letters. One piece of advice given by almost all of the experts is that writers should try to exude an energetic attitude, yet these same authorities do not delineate just how to display such a posture in the letters themselves. Third, examination of the letters reveals that one way that experts insert verve into cover letters is to use verbals, particularly gerunds, participles, and infinitives. In fact, 92.58% of the sentences in the 13 model letters have some type of verbal in them. The advantage of employing verbals is that while they are used for other parts of speech, they still retain the residue of action in their meaning. Fourth, the article describes the results of a survey to determine the acceptance of such constructions in the minds of two sets of readers: first-year writing students and third-year technical writing students. In both groups, more than 75% of the students preferred a paragraph with verbals in it over a paragraph devoid of verbals. Finally, the article suggests “sentence combining” as a procedure for teaching technical writing students how to combine basic sentences into verbals to garner variety and economy, one of the hallmarks of technical writing.

    doi:10.2190/87yv-m9wb-gj6f-r7a1
  2. Book Reviews: The Internet Edge: Social, Technical, and Legal Challenges for a Networked World, Content and Complexity: Information Design in Technical Communication, Flash Effect: Science and the Rhetorical Origins of Cold War America
    doi:10.2190/v2e2-9y17-xenm-kh2x
  3. Questioning the Motives of Technical Communication and Rhetoric: Steven Katz's “Ethic of Expediency”
    Abstract

    By emphasizing the negative meanings of words, ignoring variations in translations, and quoting out of context, Steven B. Katz has argued in an influential article that an “ethic of expediency … underlies technical communication and deliberative rhetoric, and by extension writing pedagogy and practice based on it.” Katz's assertion misrepresents the motive of technical communication and its pedagogy, and it brings discredit to the professions of technical communication and the teaching of technical communication. His attempt to discredit the motive of technical communication is part of a two-millennia-long contest for status between intellectuals and the working classes, and it creates unnecessary mistrust at a time in history when people must focus even more on cooperating socially in order to sustain democratic cultures and our physical environment for future generations.

    doi:10.2190/mdbj-pw8f-f7gj-ljg3