Advantages and Challenges of Creating User Documentation in Agile Development Contexts: A Qualitative Interview Study

Journal of Technical Writing and Communication Jan 2026

Advantages and Challenges of Creating User Documentation in Agile Development Contexts: A Qualitative Interview Study

Marjorie Rush Hovde University of Indianapolis ; Brea Threatt Indiana University – Purdue University Indianapolis

Abstract

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.

Journal: Journal of Technical Writing and Communication
Published: 2026-01-13
DOI: 10.1177/00472816251408784
Open Access: Closed
Topics: qualitative research technical communication affect and writing

Citation Context

Cited by in this index (0)

No articles in this index cite this work.

Cites in this index (2)

Friess (2023)

Scrum in Classroom Collaborations: A Quasi-Experimental Study

Journal of Business and Technical Communication
Friess et al. (2021)

“Dude, that Sucks”: Examining Scrum’s Influence on Empathy in Student Teams

Technical Communication Quarterly

Also cites 20 works outside this index ↓

10.1007/978-981-10-8848-3_62

↗
10.1080/1553118X.2021.1887875

↗
10.1109/TPC.2019.2911461

↗
10.1145/3626203.3670621

↗
10.1016/j.socscimed.2021.114523

↗
10.1177/875697281704800301

↗
10.31468/cjsdwr.502

↗
10.4324/9780429201141-5

↗
Hovde M. R. (2022). Procedural knowledge and discourse in technical communication: Easy as 1 2 3? Assembling …

↗
10.1109/TPC.2025.3585658

↗
10.1007/s12599-013-0282-4

↗
10.3127/ajis.v27i0.4501

↗
10.4324/9781315171418

↗
10.1016/j.procs.2019.12.210

↗
10.1016/j.sbspro.2015.01.1223

↗
Pasuksmit J. Thongtanunam P. Karunasekera S. (2021). Towards just-enough documentation for agile effort estim…

↗
10.1007/s10664-008-9065-9

↗
10.1080/87567555.2012.669425

↗
10.1080/1553118X.2021.1898147

↗
10.4324/9781315231556

↗

CrossRef global citation count: 0 View in citation network →