Journal of Technical Writing and Communication
381 articlesApril 2007
-
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.
January 2007
-
Abstract
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, 18th-century 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 straight-forward, to raise billions of dollars every year charity letters use sophisticated appeals to pity that have a long and interesting history.
October 2006
-
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.
-
London through Rose-Colored Graphics: Visual Rhetoric and Information Graphic Design in Charles Booth's Maps of London Poverty ↗
Abstract
In this article, I examine a historical information graphic—Charles Booth's maps of London poverty (1889–1902)—to analyze the cultural basis of ideas of transparency and clarity in information graphics. I argue that Booth's maps derive their rhetorical power from contemporary visual culture as much as from their scientific authority. The visual rhetoric of the maps depended upon an ironic inversion of visual culture to make poverty seem a problem that could be addressed, rather than an insurmountable crisis. This visual rhetoric led directly to significant features of and concepts in western societies, including the poverty line and universal old-age pensions (social security).
April 2006
-
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.
-
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.
January 2006
-
Effective Computer Text Design to Enhance Readers' Recall: Text Formats, Individual Working Memory Capacity and Content Type ↗
Abstract
This study investigated the effects of two different computer texts on readers' recall with three different content types (Blocked Constructs, Ordered Constructs, and Detail Layered Constructs) based on individuals' different working memory capacities. The findings indicated that the format and content types influenced how well information was remembered among readers. Participants with low working memory who read traditional scrolling text produced better recall scores than those who read the paged hypertext in two of the three content types. However, for those with high working memory capacity, all results came out differently depending on the content types.
October 2005
-
Abstract
Claims about the emergence of a new type of social aggregation—“virtual community”—cover a type of ideological discourse about social interactions. The main cultural resource fueling this ideology is the counterculture and its social project. Virtual community, both as a discursive and as a social practice, is a culmination rather than a resolution of the modern conflict between community and individuality. Presenting virtual community as a panacea for modern social tensions, especially that between individualistic and communitarian ideals, hides from sight not only some of the negative aspects of on-line social life (cliquish behavior and incivility) but also the role played by communication technology in fragmenting modern society.
July 2005
-
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.
April 2005
-
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.
-
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.
January 2005
-
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.
-
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.
-
The Implications of the Role of Models in Empirical Sciences for Constructing the Framework for Natural Language Communication Models ↗
Abstract
Communication practice can be aided significantly by good communication models. In this article, the author positions models of communication in natural language within a broader perspective sketched by the role of models used in empirical sciences in order to outline the foundational limitations for constructing linguistic/communication models.
October 2004
-
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.
January 2004
-
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.
-
Abstract
This article studies the stylistic variation in the design of administrative forms in three European countries—the United Kingdom, Italy, and Spain—through the linguistic analysis of a small corpus of multilingual administrative forms dealing with pension benefits and other kinds of allowances written in four different languages—English, Spanish, Italian, and German. The analysis included both monolingual administrative forms—written in English, Spanish, and Italian—and bilingual Italian/German and Italian/English forms. The purpose of the study was to search for cross-linguistic regularities in the design of administrative forms which would enable their characterization as a genre, both in terms of its staging structure and of the linguistic and formatting features of the elements which configure it as such. The analysis performed on the small corpus yielded interesting stylistic differences and tendencies in the design of comparable administrative forms in the different countries, characterized by different socio-cultural back-grounds. It is suggested that these differences are a reflection of the social attitudes of the different administrations toward their citizens.
-
Leadership Styles between Technical and Non-Technical Superiors: Guess Who Will Give Subordinates More Freedom on the Job? ↗
Abstract
Is there a difference in the dominant leadership style between technical and non-technical superiors? Which leadership style of superiors will give their subordinates more freedom on the job? By using House's Path-Goal Model [1] in a study involving a survey of subordinates of 100 technical and 100 non-technical companies in Singapore, I found that technical superiors tend to adopt a supportive leadership style, while non-technical superiors adopt a more achievement-oriented one. This manifests in significant differences between the two kinds of superiors in the extent of the leader's position power (formal authority), the degree of autonomy subordinates want, and the extent subordinates control their goal achievements.
-
Abstract
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.
July 2003
-
Abstract
As technical communication gains the technology to deliver dynamic custom documents, the importance of audience analysis increases. As a major factor in supporting dynamic adjustment of document content, the audience analysis must clearly capture the range of user goals and information needs in a flexible manner. Replacing a linear audience analysis model with a multidimensional model provides one method of achieving that flexibility. With a minimum of three separate dimensions to capture topic knowledge, detail required, and user cognitive ability, this model provides the writer a means of connecting content with information requirements and ensuring the dynamic document fits varying audience needs.
-
Using New Technology to Assess the Academic Writing Styles of Male and Female Pairs and Individuals ↗
Abstract
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.
April 2003
-
“Something in Motion and Something to Eat Attract the Crowd”: Cooking with Science at the 1893 World's Fair ↗
Abstract
Studying past examples of successful technical communication may offer insight into strategies that worked with technologies and audiences in an earlier time. This article examines the texts documenting a controversy before and during the Chicago World's Fair of 1893. Ellen Swallow Richards, chemist at the Massachusetts Institute of Technology, and Bertha Honore Palmer, president of the Fair's Board of Lady Managers, had distinctly different visions of how cooking technology should be presented. Palmer invited Richards to create a Model Kitchen in the Woman's Building, but Richards wanted to avoid gendering the new knowledge of nutrition and she fought to control her exhibit. The multimedia Richards used in her resulting Rumford Kitchen exhibit reminds us that sometimes an entertaining but familiar atmosphere might be the best way to introduce threatening new knowledge and technology, particularly to our increasingly international and intergenerational audiences.
-
Abstract
This article studies a set of scientific/technical articles published in Internet homepages. Focusing upon current trends on genre theory and the functional approach deployed by Halliday and Martin [1], linguistic features and schematic structure are analyzed in relation to more standard genres. The structural analysis suggests that these kind of texts imaginatively realize and assume the standpoint and main tenets of a lay audience that just consumes specific genres, most being analogous to the persuasive, manipulative, amusement-oriented genres of TV news stories, tabloids, and commercials. It is pondered that much of the “technological utopianism” (term used by Kling [2] surrounding the ever increasingly standardized Internet discourse turns the Internet into a productive vehicle to sustain technoscience as modern myth by spreading and forging that utopian imagery into the audience's consciousness, and that scientists are taking fruitful advantage of the utopian, futurist, and often sensationalist accounts of the Internet as a formidable frame to advertise themselves and the deeds achieved in their laboratories.
October 2002
-
Abstract
The antecedents of literary autobiography as we know it today emerged during the 17th century against a backdrop of the rise of empirical science and inductive method. An arguably older form of autobiography—the portfolio—has, unlike the literary biography, languished on the periphery of academia during our time. While it should not be controversial to say that possession of an heuristic bent is one mark of a successful education (since learning how to think, that is learning how to be open, alert, engaged, is the fundamental mission of the student), the portfolio has been ignored in part because of its modern connotation as a ‘marketing’ tool but perhaps more significantly because as a heuristic methodology it is a threat to the centrality of the pedagogue. I argue that the portfolio deserves at very least a re-evaluation throughout academic (to say nothing of quotidian) life as an indispensable tool of the spirit of pedagogy. Like the autobiography, it is validated by the belief that gathering data or details about individual lives has to precede drawing general conclusions or seeing any overarching patterns.
-
Abstract
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.
July 2002
-
Book Reviews: E Learning: Strategies for Delivering Knowledge in the Digital Age, Landmark Essays on ESL Writing, Interface Design & Document Design, Teaching Secondary English, Handbook of Instructional Practices for Literacy Teacher-Educators: Examples and Reflections from the Teaching Lives of Literacy Scholars, Authoring a Discipline: Scholarly Journals and the Post-World War II Emergence of Rhetoric and Composition ↗
April 2002
-
Abstract
XML is a recent Web design language that will enable technical communicators to produce documentation that can reuse information and present it across multiple types of media for diverse audiences. However, little is understood about how XML will impact technical communication in terms of theory, academic research, and pedagogy. In this article, I argue that XML requires more interdisciplinary approaches toward the teaching and research of technical communication, particularly with respect to the integration of technical and rhetorical knowledge.
January 2002
-
Book Reviews: From Millwrights to Shipwrights to the Twenty-First Century: Explorations in a History of Technical Communication in the United States, Spurious Coin: A History of Science, Management, and Technical Writing, Double Fold: Libraries and the Assault on Paper, Interacting with Audiences: Social Influences on the Production of Scientific Writing, a Short History of Writing Instruction: From Ancient Greece to Modern America, Contrastive Rhetoric Revisited and Redefined ↗
October 2001
-
Abstract
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.
-
Abstract
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.
-
Abstract
The commonsense principles of modern document design are direct descendants of the principles used in the Books of Hours, a hybridized religious instruction manual created in the commercial scriptoria of the 13th century. This article analyzes the design of Books of Hours and discusses how these medieval documents fit within the four design criteria (supertextual, extra-textual, intratextual, and intertextual) put forth by Kostelnick and Roberts [1]. The analysis reveals the early user of good document design features as the medieval scriptoria worked to address the audience and task requirements of the Books of Hours.
-
Abstract
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.
July 2001
-
Abstract
The constant emphasis on specialization produces university graduates who do not or cannot look at problems broadly. As a result, engineers, scientists and executives—indeed graduates in all fields—including the supposedly broad-based humanities—often cannot solve problems that require knowledge outside of their specializations. Or their narrowness causes them to commit embarrassing blunders that could be avoided if they took a broader view. The case of the British Westland Lysander P12 Ground Strafer aircraft illustrates the problem of narrow thinking. Very little direct information is available on this ingenious but obscure prototype airplane, but by examining many peripheral matters we can determine not only why the P12 was built but also how it was built. Further, we can also determine why it failed. Had the initial designers approached the problem in a broad way, and using information that was then available, they would have seen in advance that the project would fail. The case is instructive as an industrial problem, but it also demonstrates the value of global thinking methodology.
April 2001
-
Book Reviews: Writing in a Milieu of Utility: The Move to Technical Communication in American Engineering Programs, 1850–1950: Constructing Environmental Discourse: Technical Communication, Science and the Public: Technical Communication, Deliberative Rhetoric, and Environmental Discourse: Connections and Directions: Manifest Rationality: A Pragmatic Theory of Argument: Designing Interactive Worlds with Words: Principles of Writing as Representational Composition ↗
-
Analysis of the Communication Components Found within the Situational Leadership Model: Toward Integration of Communication and the Model ↗
Abstract
This article identifies and assesses the effectiveness of communicating expectations, listening, delegating, and providing feedback in relation to the Hersey-Blanchard Situational Leadership model. It reviews the correlation between task versus relationship behavior that forms the basis of the Situational Leadership model. Then the article summarizes information found in literature on effective techniques for the four skills stated above. As these techniques are identified, they are discussed in relation to their effective use in the Situational Leadership model. To understand the application of the model in businesses and its impact on managers' communication effectiveness, we conducted a study of an operational department of a Fortune 500 financial services company. The results and content analysis of a survey we administered by random selection of the managers in this department indicate that successful use of the Situational Leadership model relies on effectiveness in four communication components: communicating expectations, listening, delegating, and providing feedback. Finally, we recommend areas of future research such as comparison analysis of surveys, interviews, and focus groups with subordinates of managers who have been trained on the Situational Leadership model and those who have not.
January 2001
-
Abstract
This paper is a critique of current approaches to the development of computer graphing and graph visualization programs. Developers of these programs model the user as an individual problem solver who is reliant on perceptual skills to create and interpret graphed information. Such a model of graphing is ill-suited to meet the complex needs of real users, a supposition that is supported by work in two major areas of graphing theory and research: the sociology of science and the educational research of mathematics and scientific students. These areas have not been traditionally cited when planning computer graphing or visualization programs or when assessing their usability. A review of the literature in these fields reveals that an over-reliance on a user's perceptual skills is unlikely to result in successful graph practices.
-
Grappling with Distributed Usability: A Cultural-Historical Examination of Documentation Genres over Four Decades ↗
Abstract
Traditional models of usability assume that usability is a quality that can be designed into a particular artifact. Yet constructivist theory implies that usability cannot be located in a single artifact; rather, it must be conceived as a quality of the entire activity in which the artifact is used. This article describes a distributed approach to usability, based on activity theory and genre theory. It then illustrates the approach with a four-decade examination of a traffic accident location and analysis system (ALAS). Using the theoretical framework of genre ecologies, the article demonstrates how usability is distributed across the many official and unofficial (ad hoc) genres employed by ALAS users.
October 2000
-
Abstract
Emphasis on page design, as an aid to visual accessibility, did not receive attention in modern technical writing until the 1970s. However, accounting documents and instructional texts utilized format and document design strategies as early as the twelfth century to enhance the organization of quantitative data and linear bookkeeping entries. Format in text was used to reflect the arrangement used in oral accounting practices and to produce uniform documents. Thus, format was integral to the rise of pragmatic literacy of the commercial reader. During the Renaissance, these early format strategies received impetus from Ramist method. The result was design strategies that attempted to capture the rigid principles of organization fundamental to commercial accounting. These early accounting documents also illustrate the plain style that would become the focus of the later decades of the seventeenth century. Clarity in language paralleled clarity in page design for the sole purpose of eliminating ambiguity on the page and on the sentence level. Plain style was thus nurtured by financial forces long before the advent of natural science.
April 2000
-
Abstract
Studying corporate documents provides clues to the larger philosophy of the organization. This article explores a sales document redesign that indicates a subtle shift in ideology for a women's clothing company. The corporation uses direct sales to market clothes to a variety of women. In one season, the documents change from relatively outdated designs to more updated, professional layouts. However, the content of the documents changes very little. The author contends that the document redesign indicates a move to a more feminist outlook for the company and uses the concept of ethos to describe how the document design represents a slowly changing ethos for the corporation. A specific content shift towards feminism is, however, less apparent.
-
Learning-To-Communicate and Communicating-To-Learn in Veterinary Medicine: A Survey of Writing, Speaking, and Reading in Veterinary Medical Curricula ↗
Abstract
This article reports the results of a survey of thirty-one colleges of veterinary medicine in the United States and Canada to identify common writing, speaking, and reading tasks performed by veterinary medical students and practicing veterinarians. From the twenty-seven colleges that responded (87% response rate), we learned that writing, speaking, and reading tasks are assigned in almost every veterinary medical course and that the communication tasks assigned in veterinary medical courses accord well with the communication tasks expected to be performed by practicing veterinarians. Along with these learning-to-communicate tasks, veterinary medical students are also assigned communicating-to-learn tasks. Unlike many of the writing-to-learn tasks associated with writing-across-the-curriculum programs, communicating-to-learn tasks in veterinary medical courses seem concerned with teaching students to think like veterinary medical practitioners. The emphasis on communication in veterinary medical curricula is probably due to some extent to the emphasis on problem-based learning, a curricular innovation popular in veterinary medical education. Problem-based learning requires that instruction be designed around cases or problems to be solved rather than topics or information to be covered. This merging of research and practice in the education of veterinary medical students may offer lessons for the education of professional practitioners in technical communication.
January 2000
-
Influence of Burke and Lessing on the Semiotic Theory of Document Design: Ideologies and Good Visual Images of Documents ↗
Abstract
The syntactic aspect of semiotic theory, especially its “aesthetic principle,” is very influential in document design theories and practices. It has its roots in Burke's and Lessing's gender-related theories of images. Thus, it is laden with ideologies: it embodies our patriarchal attitudes and our iconophobia. Employing the semiotic theory in document design, we are making choices to reinforce the gender-related ideology in Burke's and Lessing's theories. It is time for us to re-conceive the “aesthetic principle” by de-emphasizing it and to adopt the reconciliation approach to design effective documents targeted at various rhetorical situations.
October 1999
-
Abstract
Despite claims for at least the past quarter century of mature professional status for the field of technical communication, studies in the history and sociology of the professions provide criteria that suggest we are not yet truly a profession. This article reviews economic, sociopolitical, and ideological factors that characterize the modern professions and argues that the technical communication field, at best, only partially meets the criteria. The prospects for professional status of technical communication might be improved by developing a critical consciousness of the processes of professionalization and concertedly acting in ways that facilitate those processes.
July 1999
-
Abstract
Work with structured abstracts—which contain sub-headings in a standard order—has suggested that such abstracts contain more information, are of a higher quality, and are easier to search and to read than are traditional abstracts. The aim of this article is to suggest that this work with structured abstracts can be extended to cover scientific articles as a whole. The article outlines a set of sub-headings—drawn from research on academic writing—that can be used to make the presentation of scientific papers easier to read and to write. Twenty published research papers are then analyzed in terms of these sub-headings. The analysis, with some reservations, supports the viability of this approach.
-
Book Reviews: Computers and Technical Communication: Pedagogical and Programmatic Perspectives: Foundations for Teaching Technical Communication: Theory, Practice, and Program Design: Reader Feedback in Text Design: Validity of the Plus-Minus Method for the Pretesting of Public Information Brochures: The Practice of Technical and Scientific Communication: Writing in Professional Contexts ↗
April 1999
-
Abstract
While some models of computer writing environments have emerged in the literature on writing, most of them are done with the purpose of helping writers in an academic context and very few, if any, with the aim of facilitating the work of professional writers or students in professional writing. We think, however, that we can learn from the previous models to build a multi-purpose computer writing environment that will take into account the needs of the professional writers as well as those of the students learning to write. We will begin by looking at some models of writing proposed by Hayes and Flower in 1980 and also at the model of White and Arndt. Afterwards, we will review the model of professional writers developed by Clerc and link it with the previous models. We will then have to look at some computer writing environments described in the literature and see how these environments take into account the process and tasks identified in writing. Finally, we will suggest our model.
-
The Browser War: An Ethical Analysis of the Struggle between Microsoft and the U.S. Department of Justice ↗
Abstract
The ongoing antitrust battle between the U.S. Department of Justice and Microsoft Corporation presents technical communicators with two ethical questions: 1) Is it right, good, or fair for Microsoft to give away its Internet Explorer browser? 2) If Microsoft gains monopoly control over the PC browser market, will this be good for us? In this article, I exam these questions using traditional rights-based ethical theory (Kant), utilitarianism, and John Rawls' principles of justice, concluding that it is neither good nor fair for a company having a near-monopoly over a market to sell products below fair market value, nor is it good that one company stands to gain monopoly control over the PC browser market. When the discussion turned to Netscape, one Intel executive, who asked not to be identified, recalled Martiz [Paul Martiz, Microsoft Group Vice President, Platforms & Application] saying: “We are going to cut off their air supply. Everything they're selling, we're going to give away for free” [1]. “We're giving away a pretty good browser as part of the operating system. How long can they survive selling it?”—Statement by Steve Ballmer, Microsoft President and CEO [2]. “Our business model works even if all Internet software is free,” says Mr. Gates. “We are still selling operating systems.” Netscape, in contrast, is dependent upon its Internet software for profits, he points out.—Statements by Bill Gates, Microsoft Chairman [3]. Only a monopolist could study a competitor and destroy its business by giving away products—Statement by Scott McNealy, Sun Microsystems Chairman [4].
January 1999
-
Abstract
The law has long been shaped by the technical aspects of compiling, writing, storing, and accessing textual verbiage. Text media technology affects all areas of the law, from its intellectual basis to its promulgation, dissemination and enforcement. From America's Colonial period, the operative state of the art of printing has accordingly shaped the development of the law in America, and has caused it to grow in a different direction from the law of England. Since the Colonial period, the state of the art of text media technology has made quantum evolutionary leaps forward, impacting American law in the process. Artifacts of these text media technologies are to be found in the statutes, legislative histories, judicial decisions, and other legal materials. Modern technology has accelerated the pace of text media technology development, and has impacted the law accordingly. Current developments continue to impact the law on an ongoing basis, and future developments in text media technology can be expected to leave their impact upon the law.