Ten Engineers Reading: Disjunctions Between Preference and Practice in Civil Engineering Faculty Responses    

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.

Smith Taylor, Summer and Martha D. Patton. Journal of Technical Writing and Communication (2006). Articles>Education>Engineering>Writing

Testing the Usability of Interactive Visualizations for Complex Problem-Solving: Findings Related to Improving Interfaces and Help    

In visual querying, users analyze data for their decisions and problems by interacting with graphics that are dynamic and linked. This querying paradigm is new, a dramatic break from the more familiar retrieving of data via search statements and displaying of it in static charts and graphs. For this new visual querying paradigm, analysts conceptually and operationally need to master new approaches. To discover salient relationships, they need to manipulate displays. To drill down for detail or causes, they have to select data of interest directly from a graph. And to draw inferences, they have to consider meanings across several dynamically linked graphics. With the aim of studying users success in these new approaches, particularly focusing on the approach of directly selecting data from graphs, I conducted a scenario-based usability test with 10 data analysts. They interacted with visualizations to complete a realistic complex analysis evaluating employee performance. Test findings reveal a range of difficulties in visual selection that, at times, gave rise to inaccurate selections, invalid conclusions, and misguided decisions. To overcome these difficulties, support for visual selection needs to be built into interfaces and help. Results and recommended improvements are presented.

Mirel, Barbara E. Journal of Technical Writing and Communication (2001). Articles>User Interface>Usability>Visual Rhetoric

Textual Grounding: How People Turn Texts Into Tools    

The author argues that users see texts as tools when they recognize the texts' specific value and function within highly localized use settings. The author argues that users "ground" their texts to local use settings by altering the ways in which the texts structure and represent information (e.g., underlining, annotation, and sketching). The author discusses three practices by which texts are grounded as tools in document reviews: mode shifting, layering, and marking. These practices reflect different ways by which users add, subtract, and restructure information in a text so that it is usable under very specific conditions. This article explores document review as a practice in which grounding is the object of discussion (how others use the reviewed documents) and a practice by which review is facilitated. These observations will be important for exploration of technology to support "grounding" practices.

Swarts, Jason. Journal of Technical Writing and Communication (2004). Articles>TC>Collaboration

Theories of Visual Rhetoric: Looking At The Human Genome    

For too long, journal articles and textbooks on scientific and technical discourse have adopted a positivistic approach to visuals. Unfortunately, this approach is problematic. It ignores that visuals are constructions that are products of a writer's interpretation with its own power-laden agenda. For example, in representing a tamed and dominated nature, visuals become instruments of patriarchy. Reading them responsibly requires that we uncover some of the values attached to the strategies of creating visuals and to the objects created. This article reviews the current approach taken by composition scholars, surveys richer interdisciplinary work on visuals, and-- by using visuals connected with the Human Genome Project--models an analysis of visuals as rhetoric.

Rosner, Mary. Journal of Technical Writing and Communication (2001). Articles>Graphic Design>Visual Rhetoric

There's More to the Title than Meets the Eye: Exploring the Possibilities    

There is little research on the use of titles in academic articles, and even less on different types of titles. In this article Crosby's taxonomy of titles [1] is brought up-to date and extended. Twelve types of titles are distinguished. The author argues that it would be helpful to discuss these different types with student writers.

Hartley, James. Journal of Technical Writing and Communication (2007). Articles>Writing>Information Design

Thinking in Pixels: An Editing System for Electronic Texts    

On-line publication alters the relationship between editor and writer, creating a potentially more collaborative and fluid text. This article explores implications of increased publication options and examines conceptual distinctions among Fixed-Format, Electronic, and Meta-media Editors. We propose a keyboard editing/commenting technique that will work across platforms and software programs and in every mode of electronic communication including simple e-mail. This ASCII based system uses only four symbols in various combinations to convey all of the print editor's marks and also allows the editor or reader to insert comments in the immediate context. The result is increased efficiency and flexibility for writer and editor or teacher and student.

Kuhlenschmidt, Sally, Charmaine Mosby, Sally Kuhlenschmidt and Charmaine Mosby. Journal of Technical Writing and Communication (2001). Articles>Publishing>Online>Methods

To Attract or to Inform: What Are Titles For?    

This article critiques some titles in journal articles for being misleading and it argues that titles need to be informative. Examples are given of work on measuring the effectiveness of titles in two areas--sentence structure and reader comprehension--and the article concludes with brief comments on the effectiveness of book titles.

Hartley, James. Journal of Technical Writing and Communication (2005). Articles>TC>Writing>Metadata

Toward a Critical Perspective of Culture: Contrast or Compare Rhetorics    

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.

Wang, Junhua. Journal of Technical Writing and Communication (2008). Articles>Language>Rhetoric>Cultural Theory

Toward an Informed Citizenry: Readability Formulas as Cultural Artifacts    

After World War II, the United States government and citizenry were concerned with truth, propaganda, democracy, and national security as they entered the Cold War era. This was a time when technocrats, engineers, and scientists could lead our free-world government through the perils of our tense relationships with Russia, Red China, and Korea. In the early 1940s, Rudolf Flesch began developing what he termed a "scientific rhetoric" to help writers of functional documents more effectively communicate technical information to a general public. He came up with a readability formula to help writers evaluate whether their writing was effective and this readability formula has profoundly shaped notions of "clear writing" for the last 60 years. This article explores Flesch's development of this readability formula, placing his work in a historical context, as well as discussing how the readability formula fit into a larger project to make effective writing more of a science than an art.

Longo, Bernadette. Journal of Technical Writing and Communication (2004). Articles>Writing>Assessment>Formulas

Toward Sociocultural Sensitivity in Rhetorical Studies of Analogy: Theoretical and Methodological Considerations    

In their macroscopic approach to analogy, rhetorical studies project the latent assumption that sound analogical reasoning is a universal property of human consciousness rather than a socioculturally inherited practice that varies over time and place. After drawing briefly from landmark work in the social sciences to show notable cases of cultural variation in analogical reasoning, I present Lev Vygotsky's concept of internalization and Dedre Gentner's structure mapping theory of analogy as fruitful theoretical and methodological avenues through which to detect sociocultural variation in analogical reasoning practices in science.

Little, Joseph. Journal of Technical Writing and Communication (2001). Articles>TC>Linguistics>Tropes

Tracing W.E.B. Dubois' "Color Line" in Government Regulations    

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.

Williams, Miriam F. Journal of Technical Writing and Communication (2006). Articles>TC>Government>Ethnicity

Training Teachers and Serving Students: Applying Usability Testing in Writing Programs    

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.

McGovern, Heather. Journal of Technical Writing and Communication (2007). Articles>Education>Usability>Testing

Trends in Entry-Level Technology, Interpersonal, and Basic Communication Job Skills: 1992-1998    

This longitudinal study was conducted to identify trends in entry-level technology, interpersonal, and basic communication competencies and skills using entry-level classified newspaper advertisements from ten standard U.S. metropolitan statistical areas. Two competencies and one skill were selected from the Workplace Know-How's identified by the 1991 U.S. Department of Labor Secretary's Commission on Achieving Necessary Skills (SCANS). Specifically, ads including interpersonal competencies increased for the fourth consecutive year; ads including basic communication skills increased for the second consecutive year. Ads including technology competencies decreased slightly; however, the overall trend for technology remains strong. Therefore, the workplace continues seeking the competencies and skills advocated by the SCANS authors.

Bryans North, Alexa and William E. Worth. Journal of Technical Writing and Communication (2000). Careers>Business Communication>Technology>History

Two Centuries of Progress in Technical Communication    

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.

Connatser, Bradford R. Journal of Technical Writing and Communication (2007). Articles>TC>History>United States

The Two Shuttle Accident Reports: Context and Culture in Technical Communication    

Dombrowski, Paul M. Journal of Technical Writing and Communication (2006). Articles>TC>Reports>Engineering

Typographic Settings for Structured Abstracts    

Structured abstracts contain more information, are of higher quality, and are easier to search and read than are traditional abstracts. However, there is a bewildering variety of ways in which structured abstracts can be printed and little is known about how the typography of structured abstracts can affect their clarity. The aim of this article is to delineate some of these major typographic variables and to comment on their effects upon the layouts of structured abstracts.

Hartley, James. Journal of Technical Writing and Communication (2000). Design>Document Design>Typography

"Unattached" Clauses in Technical Writing    

The views concerning "dangling participles" of grammarians, usage experts and authors of books on technical writing are reviewed and compared. Although many unattached clauses are clearly unacceptable, some are less objectionable and still others are acceptable practice. Absolute constructions and other clause-relational participial, infinitival and verbless clauses need no attachment to a proximate noun or noun phrase, and logical clauses that are not attached to a noun are shown as normal, acceptable use. Even clearly adjectival clauses are often unattached when followed by the passive voice, intransitives and several other grammatical structures; clauses between the subject and verb and at the end of the sentence are also often not attached to the immediately preceding noun. Cultural (perhaps also gender) differences between humanistic teachers and task-oriented engineers are noted as possible causes of different viewpoints regarding the use of unattached participles, and greater acceptance of the many acceptable forms of unattached clauses is argued. <em>Suggested Reading Approach</em> The first three sections (on principles, authoritative views and theoretical background) could be skimmed if you are already familiar with the background.

Jordan, Michael P. Journal of Technical Writing and Communication (1999). Articles>Writing>Grammar>Technical Writing

Understanding Statistical Significance: A Conceptual History    

Few concepts in the social sciences have wielded more discriminatory power over the status of knowledge claims than that of statistical significance. Currently operationalized as a = 0.05, statistical significance frequently separates publishable from nonpublishable research, renewable from nonrenewable grants, and, in the eyes of many, experimental success from failure. If literacy is envisioned as a sort of competence in a set of social and intellectual practices, then scientific literacy must encompass the realization that this cardinal arbiter of social scientific knowledge was not born out of an immanent logic of mathematics but socially constructed and reconstructed in response to sociohistoric conditions.

Little, Joseph. Journal of Technical Writing and Communication (2001). Articles>Research>Statistics>History

The Use of Pathos in Charity Letters: Some Notes Toward a Theory and Analysis    

Americans contribute $240 billion dollars to charities each year, raised in part by writing letters to potential donors. While it is debatable what the reasons are for donors to give so much money, most donors seem to be moved to contribute by pathos, particularly pity. The concept of pathos as a rhetorical appeal has become more complex over the years, growing from a simple strategy to a complicated set of parameters requiring careful delineation. Beginning with the Greeks, particularly Aristotle, pathos was defined with greater clarity (especially the concept of enargia), with Aristotle's formal definitions of the emotions, and with the use of an image upon which to direct the audience's pity. Cicero adds to the theory by calling for the use of pathos in the peroration and reinforcing Aristotle's emphasis on careful audience analysis. St. Augustine and those who follow, including Renaissance, 18thcentury rhetoricians, and 20th-century scholars like Kenneth Burke, argue that style can also be an effective persuasive strategy for a pathetic appeal. Accordingly, the charity letters examined illustrate not only Aristotle's and Cicero's tenets but also show that elements of style, particularly rhetorical figures and schemes, are common rhetorical strategies used in these charity letters. While at first the rhetoric of charity letters seems simple and straightforward, to raise billions of dollars every year charity letters use sophisticated appeals to pity that have a long and interesting history.

Myers, Marshall. Journal of Technical Writing and Communication (2007). Articles>Business Communication>Correspondence>Rhetoric

Using Corporate Lore to Create Boundaries in the Workplace    

In the workplace setting professionals use language to create boundaries of exclusion and inclusion, using the discourses of their professions and of specific workplace domain. Some boundaries are marked by formal tests--directed memos, posted notices, stamps that read "For Your Eyes Only." Less overt forms, and arguably more effective, are specific rhetorical devices relying on knowledge of the corporate and professional culture. People are included or excluded from such cultures by their knowledge and ability to manipulate professional fables and folklore, historical data, workplace experience narratives, and practical knowledge. These discourse practices can be used to promote solidarity and positively strengthen professional cultures, but they can also be used to obstruct communication and to create social fragmentation in the workplace. This article examines some examples of discourse practices among managers and employees in the customer service department of a large manufacturing firm, and shows how knowledge of the ways that language can both include and exclude people from cultural groups in the worksite can help professional communicators facilitate more effective and responsible communication practices in workplace settings.

Racine, Sam J. Journal of Technical Writing and Communication (1999). Articles>Language>Workplace

Using Corporate-Based Methods to Assess Technical Communication Programs    

Assessment continues to be an important issue for technical communicators in both practitioner and academic contexts. In this article, we investigate methods of program assessment used by corporate learning sites and we profile value add methods as a new way to both construct and evaluate academic programs in technical communication. Our goal is to introduce value added assessment methods as one way to supplement and expand current methods of program assessment. The article initially reviews Return on Investment (ROI) indicators as a widely used model for assessing programs. However, we are critical of these indicators, suggesting that they are biased against technical communication in both practitioner and academic contexts. The article then examines and critiques assessment methods from corporate training environments. These include methods employed by corporate universities and value added process-based assessment methods. The second half of the article profiles value added methods by applying them in a brief assessment of a technical communications certificate program. We conclude that while the program uses ROI indicators as a marketing device, the value the program brings and adds to its university is the "portal" it creates for university and business community collaboration. This value cannot be fully demonstrated solely through the use of ROI indicators. The article then discusses the kinds of programmatic negotiations value added processes require within university contexts that may impose non-value added activities on departments and programs. The article concludes by critically examining the appropriateness of corporate assessment methods for academic contexts.

Faber, Brenton D., Linn Bekins and Bill Karis. Journal of Technical Writing and Communication (2002). Articles>Education>Assessment

Using New Technology to Assess the Academic Writing Styles of Male and Female Pairs and Individuals    

Background: Previous research suggests that there are advantages to writing in groups or in pairs compared with writing individually, and that men write differently from women. However, as far as we know, no one has yet used new technology to assess published academic articles written in these different modes. Method: We assembled 80 papers from recent issues of the Journal of Educational Psychology as follows: 21 authored by individual men, 21 by individual women, 19 by pairs of men, and 19 by pairs of women. We then used two computer-based measures to assess various textual features of the Abstracts, the Introductions, and the Discussion sections of these 80 papers. Results: Several differences were found between these various parts of the journal articles (e.g., the Discussions were more readable than the Introductions and these in turn were more readable than the Abstracts). However, there were few differences between the writing of pairs or individuals, or between that of men and women. Conclusions: There was no real evidence to support the notion that writing in pairs would lead to better quality articles or that there would be differences between the readability of papers produced by men and women. Such differences may occur, however, before peer review.

Hartley, James, James W. Pennebaker and Claire Fox. Journal of Technical Writing and Communication (2003). Articles>Writing>Assessment>Gender

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

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.

Henson, Darold Leigh. Journal of Technical Writing and Communication (2005). Articles>Web Design>Community Building>History

The Value of Employee Participation in Strategic Planning    

A strategic planning and measurement planning project was undertaken by an 800-employee Maintenance department of a major Canadian gas transmission company to establish a stable direction and performance guide. Employee morale was so diminished from six years of constant reorganization and downsizing that the newly appointed vice-president was skeptical that the department would be able to meet its new goals unless a highly participative process was used. The project therefore was designed to use an input-reaction process between employees and managers to create a shared vision, strategic plan, and measurement system. Past projects of this nature had involved management personnel only and often goals were not achieved because few employees felt motivated by the "top-down" directives. This process produced a motivating vision, a highly doable performance plan, and a well-accepted measurement system within the allotted project schedule.

Holbrook Mort, Gail M. Journal of Technical Writing and Communication (2001). Articles>Management>Collaboration