Agile methodologies often do not explicitly include the process of creating user documentation, consistent with the idea that documentation should be minimal to create efficient processes. While Agile provides several advantages for technical communicators, these processes also raise challenges that technical communicators creating user documentation need to address, including collaborating with development teams and evaluating the usability of user documentation. Building on existing research, this qualitative study aimed to understand both the advantages and challenges of Agile and illuminate how technical communicators and their colleagues address the challenges. We interviewed 14 practicing technical communicators and their colleagues over 3 months in the fall of 2022. Participants worked in six software development organizations across the United States, with one working in Europe. We analyzed results qualitatively to discern findings focused on three topics—general advantages and challenges of creating user documentation in Agile contexts, the dynamics of technical communicators interacting with Agile development teams, and the effects of Agile on assessing the usability of user documentation. We offer suggestions for practitioners and educators as they consider how Agile affects the creation of user documentation, leveraging the benefits of Agile, and addressing challenges in innovative ways as demonstrated by participants in this study. Future research will provide even richer perspectives.

Background: The movement in recent decades from the waterfall model to the Agile framework, especially in software development, has transformed the nature of technical communication throughout product development processes. Literature review: Although several researchers have studied the roles of effective technical communication in Agile environments, more insights are needed, especially in how teams adapt Agile communication principles to fit their circumstances. Research questions: 1. How do people communicate effectively throughout phases of the Agile development process? 2. How do participants adapt typical Agile/Scrum communication practices to address challenges and fit their circumstances? Methodology: In this qualitative observational study, we interviewed and observed professionals to explore technical communication practices throughout phases of the Agile development process and to explore how teams used and modified common Agile/Scrum practices in given contexts. Results: We investigate the nature of effective technical communication throughout the typical phases of the Agile process and note a variety of ways in which participants modified conventional practices to fit their situations. Conclusion: Participants highlighted the indispensability of effective technical communication in Agile processes and developed innovative ways to adapt communication practices based on their unique experiences and situations throughout the development process. The findings illuminate useful practices and offer implications that will benefit organizations, practicing professionals, students, and educators.

Understanding technological literacy for technical communicators is crucial for effective pedagogy in technical and professional communication. Challenges of teaching technical communication students the functions and concepts of workplace software include the number of rapidly changing applications, a desire to focus on education over training, limited faculty expertise in software, limited resources for teaching software, and a desire to focus on technical communication principles. To address these challenges, the authors explore how to use a four-level framework of technological literacy along with existing resources to design a course to help students use, understand, and evaluate technical communication technology.

Research problem: In recent years, many businesses have become involved in internationalized projects, yet understanding the dynamics of engineering communication in virtual dispersed teams is limited. Research questions: How do the factors mentioned in the literature function in an international engineering project? Are there factors that enhance or constrain the work in an engineering setting that are not mentioned in previous studies? Literature review: Existing knowledge on the contextual factors that affect virtual international professional communication is mainly built on the study of the communication practices of students or business professionals who are not engineers. Results of that literature have identified factors that enhance communication for dispersed virtual teams (which include cross-cultural training, using appropriate communication technology, face-to-face communication opportunities, respect for partners, regularly scheduled meetings, a common language, a common discipline, and cross-cultural understandings though popular media). There are factors that challenge communication for dispersed virtual teams (which include differing cultural assumptions, differing cultural communication styles, US Government export control regulations, proximity and time issues, and differing levels of perceived power and influence). Methodology: This study involved observing international engineer meetings in the US and the UK and interviewing 19 engineers leading an international design team. The participants worked for the same international company with about half from the US and half in Great Britain. Results and discussion: Many of the factors identified in general professional communication studies held true for this context. But some features were unique to an engineering environment that the literature had not previously mentioned, including iplanning for and working with intercultural dispersed virtual engineering teams and that people need to consider many complexities of culture that affect communication practices. Because this study observed one team in the context of only two cultures, future research may determine whether these factors are more widely found in other teams, workplaces, and cultures. Future research may also determine the relative levels of influence of the contextual factors on international dispersed virtual engineering teams. In addition, the study of engineers learning to communicate in international settings may be illuminating.

Although most theorists agree that discourse creates meaning, they have not adequately described how this process emerges within the creation of procedural knowledge. This article explores how technical communicators in diverse settings based discourse decisions on their knowledge of (a) users, (b) organizational image and constraints, (c) software structure and features, and (d) genre conventions in order to create communication artifacts designed to help users develop procedural knowledge. The transformations in which they engaged indicated that these technical communicators were skilled in forming images in these four areas and then using these images as they created meaning in procedural discourse. In this process, they moved beyond merely translating or transmitting technical knowledge.

(2001). Research Tactics for Constructing Perceptions of Subject Matter in Organizational Contexts: An Ethnographic Study of Technical Communicators. Technical Communication Quarterly: Vol. 10, No. 1, pp. 59-95.

Discourse theories frequently emphasize the importance of understanding audience but seldom delve into how writers form conceptions of their audiences, especially in organizations. This study examines computer documentation writers’ tactics for conceiving of their audiences. Based on two ethnographic case studies and insights from activity theory, the author describes and evaluates technical communicators’ tactics for understanding audiences, constrained and supported by their organizations. She discusses the advantages and limitations of each tactic, looking at how each tactic might answer questions about audience. This research should be useful to technical communication educators as they expand students’ options for audience research in nonacademic settings. In addition, the findings of this study can enhance theories about the ways writers create images of their audiences.