Journal of Technical Writing and Communication
99 articlesApril 2023
-
Abstract
Telemedicine is an alternative healthcare delivery system whereby patients access digital technology to consult with a physician virtually. Patients first interact with telemedicine via a consumer-facing website. Telemedicine promises numerous benefits to patients, such as increased access to healthcare, yet poor usability of the telemedicine user interface (UI) may hinder patient acceptance and adoption of the service. The telemedicine UI moderates patients’ ability to utilize telemedicine, and therefore it must be usable, but it must also be rhetorical to motivate patients to perform certain actions. Digital rhetoric refers to UI elements that influence user actions and knowledge and is tied to usability because of these same human–computer interaction (HCI) factors. This study examined the usability of three telemedicine provider UIs and by identifying usability problems, reveals digital rhetoric that is significant to telemedicine UIs. The article concludes by offering heuristics of digital rhetoric that lead to optimal usability.
October 2018
-
Abstract
This research explores a presumed link between today’s use of digital media and an ever-increasing lack of rhetorical awareness in students. Specifically, the study pilots a method for measuring rhetorical awareness through students’ e-mail transactions with faculty in technical writing service courses, questioning whether rhetorical awareness has decreased in the preceding 10 years. The findings indicate that students might be more rhetorically aware today than they were 10 years ago, but levels remain below expectations.
July 2018
-
Abstract
Technical and professional communication instruction is well suited to helping students develop digital literacy but must be informed by research regarding how students are using specific social media platforms, particularly the propensity to post content that could damage their career capital. This study examined this question for students in Austria, Australia, and the United States. In Austria and Australia, this behavior was found to be no greater for Twitter than it was for Facebook. Conversely, for the United States, the behavior was found to be more pronounced. These and additional results regarding attitudes toward information privacy are reported.
July 2014
-
Abstract
Professional identity is oft explored in the field, but such identities usually reside institutionally and may exclude women who engage in professional communication from the workplace of the home. One instantiation of this extra-institutional professionalism is mom blogs, the authors of which create content, find sponsors, and address issues important to mothers. Yet the women lack legitimacy as professionals because of the title “mommy blogger” and because of the notion that blogging is a hobby. My qualitative study explores how mom bloggers claim a professional space in communication. I interviewed 22 mom bloggers, using Faber's (2002, [18]) theory of professionalism and Durack's (1997, [17]) ideas of redefining terms, such as “workplace,” to include women. My findings show that mom bloggers engage in the characteristics of professional communicators, model egalitarian professionalism, employ an ethic of care that combats elitism, and challenge the field to include their work, from the home and through new media, as professional.
October 2013
-
Abstract
It is a well-attested fact among the academia that the terminology and discourse of computer science is pervaded with metaphors. Yet, almost all the studies on metaphor application in computer science have approached the issue of the metaphor use and its influence on the user-computer interaction from an intralingual stance leaving the field of literature related to this subject with a lacking for the adoption of an interlingual attitude. The question is whether metaphor is as extensively far-reaching in its influence among the computer users across the globe as it has been pervasive in its use in computer discourse? This study, through drawing the scholars' attention to the significance of user metaphoric awareness in the receptor communities regarding the recognition of any metaphoric application based upon the notion of transparency or opacity of metaphoric meaning in terms of the user's command of the language in use in computer science, tries to put forth the idea of globalization of metaphoric meaning in computer science and its influence upon the users and at the same time propose some possible alternatives to the computer writers and decision-makers both in global and local levels in order for the user metaphoric awareness being promoted.
January 2012
-
Abstract
This article traces the influences of hypertext theory throughout the various genres of online publication in technical communication. It begins with a look back at some of the important concepts and theorists writing about hypertext theory from the post-World War II era, to the early years of the World Wide Web 2.0, and the very differing notions of its potential. A significant challenge during this formative period was the fact that limitations in technology and infrastructure placed limitations on the potential envisioned by these scholars. The ways in which we look at early scholarship differ even a decade or more later, in terms of some of the information technologies and tools we use today. In the Web 2.0 era, we see a trend of blending and extension beyond principles found within hypertext theory in the tools we use and user experiences we create with them.
April 2011
-
Outlining Purposes, Stating the Nature of the Present Research, and Listing Research Questions or Hypotheses in Academic Papers ↗
Abstract
Driving research questions from the prevailing issues and interests and developing from them new theories, formulas, algorithms, methods, and designs, and linking them to the interests of the larger audience is a vital component of scientific research papers. The present article discusses outlining purposes or stating the nature of the present research, and listing research questions or hypotheses in the introduction of academic papers. This corpus-based genre study focuses particularly on Move 3 of the model “occupying the niche.” The results indicating disciplinary variation show that the writers of Computer Science (CS) research articles, over the years have developed an increased use of outlining purpose/stating the nature of the present research, having the characteristics of purposive, descriptive, extension of the previous work, contrast to the existing work, brevity, complexity, and a description of methodology. It also shows that listing research questions or hypothesis may have distinctively different functions in developing genres as compared to the established ones such as physics.
April 2010
-
Abstract
Networked electronic text—fragmentary, mutable, connected, and instantly accessible from any computer or handheld device—challenges traditional notions of textual coherence and composition, offering affordances far beyond those possible in traditional, print-based texts, including those made available electronically. Such texts become tools, passively awaiting a user who activates, assimilates, and adapts their contents to his or her particular situation. This article explores the creators' role in such texts, roles that remain underappreciated, unstudied, and misunderstood as a new, and necessary, form of composition activity. Their work is not considered authorship in most traditional senses of composition; although it involves a number of traditional authorial tasks: the decision to connect certain fragments to others, to add affordances beyond those allowed by print, creates the potential for structural coherence and viability of a networked text, potential then realized by users, who themselves become authors of this continually changing text.
October 2009
-
Abstract
This article considers a case in which editors created for themselves an amount of power and authority within an organization through technological innovation. Using retrospective analysis and e-mail interviews, the author discusses his own previous experience as a technical editor at a U.S. Government-run research facility when electronic editing was introduced and used. The introduction of electronic editing, the author argues, was an example of technological innovation, which, as other researchers have demonstrated, can create authority within an organization.
April 2009
-
Abstract
Anti-employer blogs, those which criticize companies or their employees, are posing significant legal and ethical challenges for corporations. The important legal issue is the conflict between the employee's legal duty of loyalty to the employer and the employee's right to free speech. Although U.S. and state law describes what an employee may or may not say in a blog, corporations should encourage employees to contribute to the process of creating clear, reasonable policies that will help prevent expensive court cases. The important ethical issue concerning anti-employer blogs is whether an employee incurs an ethical duty of loyalty. In this article, I conclude that there is no such ethical duty. The legal duty of loyalty, explained in a company-written policy statement that employees must endorse as a condition of employment, offers the best means of protecting the legal and ethical rights of both employers and employees.
January 2009
-
Abstract
Phishing e-mails deceive individuals into giving out personal information which may then be utilized for identity theft. One particular type, the Personal Solicitation E-mail (PSE) mimics personal letters—modern perversions of ars dictaminis (the classical art of letter writing). In this article, I determine and discuss 19 appeals common to the PSE. These appeals were established first by conducting generative rhetorical analysis, then by volunteer coding, on 170 e-mails collected over a 12-month period. After defining these categories, I show how these letters are excellent twenty-first century teaching tools for pathos-based argumentation, logical appeals, the creation of ethos, and kairos in the development of perceived exigency.
April 2007
-
Abstract
The aim of this article is to show that a better awareness of the relationship between written and spoken communication can help the writer to improve his/her effectiveness. The focus will be on written texts that precede (formal and informal) discussions. The analysis will start with a description of the differences between orality and literacy. We shall deal with the functions of orality-based texts for the readers. Then we shall move to the writing process and explain how orality can find a place in this process, how it can be linked to creativity, and how it affects the way we plan the writing process. An oral way of writing is related to an important feature of speaking, namely fluency; but it also means a specific receiver orientation, dynamic rather than static and social rather than individual. Computer mediated communication could influence a more oral approach to written texts.
October 2006
-
Abstract
Much of America was stunned into mourning on February 1, 2003 as the space shuttle Columbia was reported to have broken up over Texas. The ensuing investigation revealed that debris at liftoff was the cause of the crash, but the official report suggested that NASA's organizational communication was just as much to blame. This article uses transactive memory theory to argue that there were significant gaps in the knowledge network of NASA organizational members, and those gaps impeded information flow regarding potential disaster. E-mails to and from NASA employees were examined (the “To” and “From” fields) to map a network of communication related to Columbia's damage and risk. Although NASA personnel were connected with each other in this incident-based network, the right information did not get to the people who needed it. The article concludes with extensions of theory and practical implications for organizations, including NASA.
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.
January 2005
-
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.
October 2004
-
Abstract
The purpose of this article is to help determine whether the use of emoticons in computer mediated communication (CMC) are truly nonverbal cues. A review of the literature revealed that the traditional nonverbal theorists failed to predict the future employment of nonverbal cues in electronic CMC. A variety of emoticons are then described including the traditional happy face ☺ and sad face ☺, numerous variations of faces employing keyboard keys, a number of abbreviations commonly in use, and FLAMING. Inasmuch as emoticons are presently in widespread though informal use, the problem of how and what business communication instructors should teach about emoticons is discussed. The conclusion reached is that of a generational recipient determinism. It is recommended that recipients who are Traditionalists (born before 1946) should not be sent e-mail with emoticons; those who are Baby Boomers (those born between 1946 and 1964) probably should not be sent e-mail with emoticons; those who are Generation Xers (those born between 1964 and 1980) may be sent e-mail with some of the more commonemoticons; and those who are termed Millenials (bornafter 1980 and coming of age after 2000) may be sent e-mail with generous use of emoticons.
July 2003
-
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
-
Technical Communication and Clinical Health Care: Improving Rural Emergency Trauma Care through Synchronous Videoconferencing ↗
Abstract
While debates continue over the effectiveness of innovative communication technologies to bring information and services to populations that have been underserved by such new technologies, a federally-funded program at the University of Vermont and Fletcher Allen Health Care (FAHC), Burlington, Vermont, has enabled trauma specialists to link with rural emergency room health care providers through a synchronous videoconferencing (telemedicine) network. Analysis of patient histories and surveys completed by the participating physicians after each use of the computer conferencing system as well as interviews and observations indicate that the FAHC consulting trauma specialists and the remotely located physicians felt the linkups do not interfere with standard ER procedures, that communication was at least adequate for all consultations, and that the consults improved the quality of care, for over half of the cases. Furthermore, interviews with rural ER physicians indicated that they saw the program operating as the first stage of FAHC's management of a patient to be transferred to that facility.
January 2002
-
Abstract
This article begins with an overview of cognitive psychology research on the effects of aging on literacy and suggests the additional complications facing older adults who consume and produce text within the frame of technology, particularly on-line usage. From an overview, the text moves to patterns corporations are using to target older adults, namely as consumers and as producers. The text then explores the use of philanthropy in the corporate literacy initiatives and suggests that there are complicated issues at hand in attempting to integrate the knowledge of aging and corporate strategies into our technical writing classrooms because we enter this discussion concerned about non-traditional students, older adults who are challenged to participate in contemporary literacy initiatives, and ourselves as aging participants as well. The article ends with suggestions of possible ways of addressing concerns regarding aging.
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.
July 2001
-
Abstract
E-mail has significantly impacted the way we communicate in business, possibly going so far as to affect the social structure of organizations. One under-explored affect of e-mail is how it impacts communication in smaller organizations. Given the ability of regular “face-to-face” interaction, is e-mail necessary to boost communication? A report of employee attitudes in one small business did provide an opportunity to observe the impact of e-mail on communications and employee attitudes. As a result, it is suspected that interoffice e-mail may serve to link formal and informal communication channels, particularly in terms of including managers to the informal communications network.
April 2001
-
Abstract
This article compares the historical and contemporary clothing industry with the current microelectronics industry. It argues that the development of paper patterns, along with the perfection of the sewing machine as a technology in the 1870s, “democratized fashion” for lower and middle class women just as the development of the World Wide Web and Web-making software has democratized publishing for authors before unable to gain access to an audience for their writing. Comparing the businesses of three groups of women using the World Wide Web, this article finally problematizes these historical and contemporary democratizing technologies—the sewing machine and the computer—by pointing out both obvious and more subtle socioeconomic realities which undercut some utopian promises of publishing in Cyberspace. Women are … without class because the cut and fall of the skirt and good leather shoes can take you across the river and to the other side: the fairytales tell you that goose-girls may marry kings [1, pp. 15–16].
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.
-
Constructing Usable Documentation: A Study of Communicative Practices and the Early Uses of Mainframe Computing in Industry ↗
Abstract
This study suggests that documentation is a complex technical communication genre, encompassing all the texts that mediate between complex human activities and computer processes. Drawing on a historical study, it demonstrates that the varied forms given to documentation have a long history, extending back at least to the early days of commercial mainframe computing. The data suggest that (1) early forms of documentation were borrowed from existing genres, and (2) official and unofficial documentation existed concurrently, despite efforts to consolidate these divergent texts. The study thus provides a glimpse into the early experimental nature of documentation as writers struggled to find a meaningful way to communicate information about their organization's developing computer technology.
July 1999
-
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.
October 1998
-
An Investigation of the Relationships among Technology Experiences, Communication Apprehension, Writing Apprehension, and Computer Anxiety ↗
Abstract
This study explored the relationships among communication technologies, communication apprehension, writing apprehension, and computer anxiety. The results indicate that significant relationships exist between computer anxiety, and computer/wordprocessing, between computer anxiety, and computer electronic discussion group, between computer anxiety and online computer service, between computer anxiety and CD-RAM, as well as other types of technology. Other results reveal that students are least experienced with programming computers, computerized electronic discussion group, computer conferencing and Integrated Service Digital Network (ISDA). Significant differences occurred between gender groups on cellular phone scores, writing stories/poetry scores, computerized electronic discussion group scores, satellite TV scores, electronic videogames scores, and computer/video conferencing scores, as well as communication apprehension scores, writing apprehension scores, and computer anxiety scores. The specifics of these results and other significant differences are reported and discussed in this article.
July 1998
-
Abstract
This article demonstrates the advantage of having students create their own Web pages (hypertexts) to enhance their awareness of the importance of rhetorical organization. Hypertexts utilize a method of linking pages to each other. This “linking function” of hypertexts causes writers of hypertexts an increased need for more attractive pages and effective presentation of information. Compared with writers of regular writing, hypertext writers also have much more choices in showing information. By letting students exploit these choices and possibilities, instructors of writing can force students to analyze the relationships both within and between pieces of information. Thus, instructors can increase students' awareness of the importance of rhetorical organization, which is mainly responsible for indicating structures and relationships of information in regular writing.
-
Abstract
For researchers, a key issue in developing electronic mail as a survey method is to understand what factors are at play as a potential respondent chooses to open or delete a mail message. This research investigated the process by which individuals make decisions about opening and reading versus deleting electronic mail and also assessed attitudes toward electronic mail surveys. The sample received an electronic mail message followed by a telephone interview. Results indicated that individuals delete mail when the subject line does not interest them or when they do not recognize the name of the individual sending the e-mail. Those interviewed reacted favorably to e-mail surveys for scientific research despite issues of anonymity. However, respondents overwhelmingly described a dislike for commercially based electronic mail surveys.
April 1998
-
Abstract
In the future, more and more technical writers across the discipline are likely to become involved in designing and developing multimedia products. Entering this new, challenging, and rewarding field requires retooling current skills used in the production of text-based information products to add knowledge of a wider range of media, including audio, video, computer graphics, digital photography, and authoring systems. This article presents an overview of the process of bringing a multimedia product to the point of sale.
January 1998
-
Abstract
Now that intranets have become the new model for information technology systems, we can expect that more organizations will adopt online document review and editing procedures. This may be problematic for technical editors. Survey studies published in 1992 and 1995 found that most technical editors were still editing on paper most of the time even though an overwhelming percentage of them had access to computers and expressed a positive attitude toward using computers for editing-related tasks. In this article I review discussions of online editing in the technical communication literature to understand how online editing has been constructed within the discipline and why many technical editors remain loyal to traditional paper-based procedures. I discuss a recent call for emulating handwritten mark-up and author queries electronically and compare this “technical fix” with the collaborative online editing affordances of the latest word processors. I then discuss studies of online reading and composition whose results suggest that the materiality of hard-copy editing procedures may contribute to some inherent advantages over online emulations of such procedures, or at least foster the widespread perception that certain advantages exist for hard-copy editing. I conclude by urging an open-minded and flexible but also critical perspective toward online editing technology. Such a perspective should help make the move to online editing a more positive experience for technical editors. It might also help them define a higher-level role for editing in the information and document development process.
October 1997
-
Does the Curriculum Fit the Career? Some Conclusions from a Survey of Graduates of a Degree Program in Professional and Technical Communication ↗
Abstract
Recent graduates of a degree program in professional and technical communication were surveyed to identify their current employment, their attitudes toward their academic preparation, and the professional courses they found most helpful. The history and curriculum of Rochester Institute of Technology (RIT's) eleven-year-old program in Professional and Technical Communication (PTC) is described, as well as the program's “professional core,” its Liberal Arts core, and its cooperative education requirement. The survey was modeled after a previous survey the authors conducted with members of the Society for Technical Communication. The results of both surveys emphasized the basics of writing and computer skills. The degree program alumni also expressed the desire for a “more practical” curriculum that placed less emphasis on theory. Anecdotal responses from the alumni provided a unique view of the field through the eyes of its newest practitioners.
July 1997
-
Using Social Learning Theory to Reduce Small Business Breakdown along the Internet Superhighway: An Exploratory Model ↗
Abstract
As the speed of travel on the “Information Superhighway” accelerates, many small-to-medium sized enterprises (SMEs) do not effectively keep pace. SME computer resistors include 1) the slow-plodding neophyte computer users in the far right hand lane, 2) the firms curious about computerization but who are yet to make a purchase decision, idling in neutral on the access ramps, and 3) the business that purchases improper equipment and/or software and ventures onto the “road” without proper training and support, being run over by the speeding industry. In the information high-tech world of the 1990s it seems amazing that an estimated quarter of all small businesses still do not have their first personal computer. This article calls upon the innovators of the communications field to look in the rear view mirror to see the businesses left behind in the information expansion race. A model utilizing social learning theory defines a framework for road service [1], getting the small business “resister” up to the information superhighway speed limit.
April 1997
-
Abstract
The 1995 appearance of Microsoft's Bob interface directly poses the question of how anthropomorphic the human computer interface design should be. A historical approach to the question offers three important observations to designers: 1) that the impulse to anthropomorphicize technology has been longstanding and has been employed with artifacts other than computers; 2) that the normal evolution of technologies proceeds through an introductory phase during which a culture becomes acclimatized to the new technology; moreover, one of the methods by which cultures have traditionally become acclimatized to new technologies is through anthropomorphization; and 3) the perception of anthropomorphism in the human computer interface has been complicated by the fact that “computers” were, in fact, first people not machines. An historical approach to answering the interface design question posed by Microsoft's Bob interface suggests that designers productively accommodate the longstanding human impulse to anthropomorphicize new technologies.
October 1996
-
Abstract
This article discusses the adequacy of two modes of presenting information on a computer screen, i.e., the alternating screen presentation in which information is presented “screen by screen” and the simultaneous screen presentation that shows different sources of information simultaneously on the same screen. Using a simultaneous or an alternating screen presentation, subjects had to perform short writing tasks, half of which required the use of one on-line document, the other half required two documents. The subjects' task performance as well as their appreciation of the task and the presentation mode were measured. The results show that performance and appreciation data do not run parallel. While all subjects clearly prefer a simultaneous mode of presenting information on the screen, performance data are much more varied and less clear cut: when reading, subjects performed significantly better in the alternating mode; when producing a text, subjects slightly benefited from simultaneous screens.
-
Abstract
Metaphors and analogies can be helpful for people when they have to learn or learn to use something. Some empirical studies into the effect of metaphors in software manuals showed a positive influence on computer task performance, although this influence proved to be a conditional one. A necessary condition must be that readers understand the metaphor used; readers must have knowledge about its source domain. The most understandable concept for all humans seems to be a human being; the metaphor with human beings as a source domain is called personification or anthropomorphism. Up to now, no coherent theory has been available about linguistic expressions that can be labeled as anthropomorphism, and no empirical data have been gathered about expressions in software manuals that are perceived as such by readers. Therefore, an explorative experiment with real manual material was carried out. Expressions suggesting that computers or programs have feelings or an affective relationship to the user, that they are able to perform non-routine (mental) activities and communicate their intentions through human language use, appear to be perceived as anthropomorphistic. Such expressions might help readers to use a computer (program) more easily.
-
Abstract
This article examines the genre of visual manuals by discussing the main forms and functions of two types in detail: step-by-step and guided tour manuals. Step-by-step manuals have a one-on-one correspondence between picture and text (explanations and instructions), reflecting the action-reaction mode in which users tend to interact with computers. Guided tour manuals give users a visual impression of the program. The pictures, mostly full-screen captures, are annotated with several paragraphs of text. An experiment is reported in which we examined whether a visual manual helps users realize tasks faster and more accurately than a non-visual manual. No effects on accuracy were found, but the visual manual did increase the speed of task execution with a significant and substantial gain of 35 percent. The conclusion draws attention to the fact that there is no single best type of visual manual, but that each has its own strengths and weaknesses.
-
Abstract
Three formats for presenting a number of similar procedures in printed instructions were compared in an experiment: separate lists, an integrated list, and a table. Participants had to operate a device on the computer screen, following procedures that were presented in one of these three formats. The integrated list format and the table format were expected to provide an overview of the features common to the similar procedures, which would help incidental learning of the procedures. However, the experiment did not yield such results. None of the formats scored significantly better than the other in the augmentation of incidental learning. Since instructions in integrated list format take more time to read in the beginning than the other formats, the integrated list format can be considered as the least favorable format.
January 1996
-
Abstract
This article examines the question “Are the same good writing and speaking skills required in general management positions also important in computer jobs?” The first part of the article examines the historical marriage between “communicating” and “computing,” while the second part examines what roles, if any, good communication skills play in advancing IS career paths. Finally, the third part describes an empirical survey to test the hypothesis that communication skills are important to computer professionals. The results of the survey strongly support the hypothesis.
July 1995
-
Abstract
There is much debate and confusion about the use of the passive voice in texts in general, and in computer manuals in particular. For example, it is often stated that the passive should be avoided, but on the other hand, it may also have a clear function in a text. The aim of this article is to provide clarity by presenting a straightforward principle for the use of the passive voice in computer manuals. This “alternation principle,” in which active voice is used for user actions and the passive voice for automatic computer, is backed by results from recent functional and cognitive linguistic research. It is illustrated by means of fragments from several computer manuals, including some (apparent) counter-examples.
October 1994
-
Abstract
Two groups of university students, approximately half with work experience, read one of two versions of the same case study narrative—a traditional, printed version or a computer version. Afterwards, both groups selected from a list of paragraphs to compose a memorandum needed to resolve the conflict in the case, and, two days later, completed a questionnaire to determine retention of the narrative. The researchers hypothesized that the subjects using the computer version would perform better and rate their version as more realistic because of this version's visuals and decision paths. The subjects using the computer version did perform somewhat better at selecting the correct final memo paragraph, but overall, the results did not show either method to be superior. The subject's previous off-campus work experience, however, did produce an impact on both the results and acceptability of the case method.
January 1994
-
Abstract
The demand for help and hypertext systems has created a problem for many documentation departments, particularly those in smaller companies inexperienced in creating these forms of online documentation. The scarcity of existing literature compounds this problem. Literature that specifically addresses how to create such systems with limited resources and considerable time constraints would ease the burden faced by these companies. This article gives writers in small companies with limited resources some suggestions for undertaking a hypertext project. The writer views help text as a simple form of hypertext, and, as such, frequently refers to both simply as “hypertext.” This article is not concerned with describing in detail the various design features of hypertext.
October 1993
-
Abstract
Computers and technology now enable the writer of a form letter to insert significant personal information about the individual recipient, the purpose of which is to induce compliance with the sender's purposes. This article is based on a project in producing medical advice letters tailored to individuals. Our evaluations, like other preliminary studies, suggest that individualizing such letters does improve compliance over the conventional (impersonal) form letter. In considering the inner logic of the individualized letter, different methods of forming personalized letters are presented: adding text, subtracting text, and rearranging text. It is shown how the requisite information can be represented by a questionnaire, a diagram, and the printed letter itself. These three components are logically connected so that the user can make various choices and letters can be quickly formulated. Finally, advice is offered to technical writers embarking on the development of an individualized form letter, with some general reflections about the future of this innovation.
-
Abstract
This study investigated the need to include computer screens in documentation for software using a graphical user interface. Minimal manual principles emphasize the need to reduce verbiage. However, some suggest that depiction of screens in documentation can help the user coordinate documentation with computer screen displays. Documentation including button, icon, and screen information was varied with software designed for file transfers. College students used one of the three manuals designed along minimal manual principles. Students who used a manual with screens were significantly slower in transferring files and found it less helpful than students using either a manual with button and icon information or one with textual information only. Therefore, documentation for graphical user interfaces should include few, if any, screens. However, there appears to be a benefit for including icon and button information in the documentation.
January 1993
-
Abstract
Twenty years ago I had no idea what a computer was. Ten years ago I knew what computers were, but I had never sat at a terminal. I just assumed that computers were machines used in those “other” disciplines, certainly not in English courses. Today, I teach my technical writing classes in a collaborative computer classroom. The classroom consists of twelve networked computers which my twenty-four students per class use in tandem. Despite my original ignorance of computers, I'm now happily ensconced in a computer classroom. In fact, computers are so important, I've concluded, that teaching writing without the aid of computers does our students a disservice. How did I make such a complete turn-around in attitude? I realized that far from being anathema, computers helped to create a perfect marriage for teaching and writing. First, computers let students write more effectively because computers are compatible with the writing process (writing and rewriting). Next, teaching students to write in a collaborative computer environment prepares our students for business and industry where they will be asked to work on group projects and to communicate electronically. Despite the values of computerizing our instruction, however, computers in the classroom present problems. Do the benefits outweigh the deficits? My answer is yes.
October 1992
-
Abstract
This article discusses two communication issues associated with the development of an Executive Information System. The first issue examines the natural communication between systems designers and the executive end-user. The second issue addresses the human-computer interaction between the computer and the executive. Top executives constitute a unique group of end-users, and systems designers should exercise a wide range of skills in the process of identifying needs and presenting information to them.
January 1992
-
Abstract
With the vocabularies of their own disciplines, students majoring in technical subjects can access fresh insights into how writers write. For example, the symbols of computer flowcharts may bring insights when used to monitor rhetoric. Charts of organizational hierarchies, such as those that many corporate executives use, may illuminate equally well the shifting hierarchies of the characters in a work of fiction. Graphs and charts of syntactic and lexical networks may reveal the hidden structures of a narrative. An engineering major needs to see how a writer engineers words, a business major to see how a writer establishes hierarchies, a computer science major to see how a writer devises the flow of rhetoric. If we encourage students to explain literature with the professional vocabularies of their own disciplines, we can train them as lively apprentices, not as drudges. If we English teachers heed our students' special vocabularies, we may expect students to examine our own jargon more thoughtfully, such as the vocabulary by which we chart subordination and punctuation. Literature is everyone's heritage. No discipline monopolizes the critical insight or the vocabulary with which to articulate it.