Journal of Technical Writing and Communication

This essay expands Perelman and Olbrechts-Tyteca’s concept of argumentation by model to bring more attention to the persuasive effects of using the self as a model. To illuminate this technique, I analyze the personal narratives of popular health coaches, who are championing a holistic health movement toward what I refer to as “do-it-yourself healthcare.” This case involves arguments regarding the efficacy of methods in evidence-based medicine and “alternative” or holistic health, as popular health coaches predicate their ability to heal themselves and others on abandoning traditional medicine. In brief, the purpose of this article is twofold: first, to characterize the rhetoric of the movement toward alternative or holistic health, and, second, to extend Perelman and Olbrechts-Tyteca’s concept of argumentation by model and address the implications of this expansion.

In the field of business and technical communication, scholars have called for research on dealing with cultural conflict for a long time. But the limited study on dealing with cultural conflicts, along with the current political context in the United States, calls for efforts to systematically address diversity issues and cultural conflict in our research and teaching practices. One obstacle to advance effective communication strategies on cultural conflict in business and technical communication is the lack of communication with other disciplines. Through an interdisciplinary perspective, the current article introduces the concept of cultural conflict, examines strategy models to address cultural conflict in different fields, and provides an example on how to identify a strategy model to resolve cultural conflict in business and technical communication practices. This article concludes by emphasizing that there is not a best model that can be applied to handle cultural conflict in all circumstances and calling for research on exploring and identifying effective strategy models to resolve cultural conflict in business and technical communication practices.

The success of an application programming interface (API) crucially depends on how well its documentation meets the information needs of software developers. Previous research suggests that these information needs have not been sufficiently understood. This article presents the results of a series of semistructured interviews and a follow-up questionnaire conducted to explore the learning goals and learning strategies of software developers, the information resources they turn to and the quality criteria they apply to API documentation. Our results show that developers initially try to form a global understanding regarding the overall purpose and main features of an API, but then adopt either a concepts-oriented or a code-oriented learning strategy that API documentation both needs to address. Our results also show that general quality criteria such as completeness and clarity are relevant to API documentation as well. Developing and maintaining API documentation therefore need to involve the expertise of communication professionals.

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.

Documenting and characterizing interactions between student interns and their mentors in the workplace offers perspective on student learning and enculturation that can help us introduce these ways of learning to students in the technical communication classroom, even before the internship. Three student intern conversations in the internship setting are the focus of this close discourse analysis, framed by 6-month-long case studies and Vygotsky’s learning theory. Results indicate that many similarities exist between classroom feedback and mentor feedback in the internship, but that differences in student agency may make negotiation important in the technical communication classroom.