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
CompPile
Search in CompPile ↗
Open Access
Closed
Topics
Export

Citation Context

Cited by in this index (0)

No articles in this index cite this work.

References (50) · 4 in this index

  1. Agile, an awesome alternative
    Intercom
  2. The power of technical communication skills in Scrum
    Intercom
  3. Usability testing essentials: Ready, set … test!
  4. Overcoming us vs. them: Working with multiple distributed scrum teams
    Intercom
  5. The impact of agile on user-centered design: Two surveys tell the story
    Technical Communication
Show all 50 →
  1. 10.1007/978-981-10-8848-3_62
  2. Commentary on Technical Communication special issue on project management: Revisiting the…
    Technical Communication
  3. Products and processes: Transition from “product documentation to … Integrated technical …
    Technical Communication
  4. 10.1080/1553118X.2021.1887875
  5. Easycomm: A framework and tool to solve client communication problem in Agile development
    IAENG International Journal of Computer Science
  6. Filling to capacity”: An exploratory study of project management language in Agile Scrum teams
    Technical Communication
  7. IEEE Transactions on Professional Communication
  8. Journal of Business and Technical Communication
  9. Technical Communication Quarterly
  10. The product is Docs
  11. 10.1145/3626203.3670621
  12. Information development: Managing your documentation projects, portfolio, and people
  13. 10.1016/j.socscimed.2021.114523
  14. 10.1177/875697281704800301
  15. 10.31468/cjsdwr.502
  16. 10.4324/9780429201141-5
  17. Hovde M. R. (2022). Procedural knowledge and discourse in technical communication: Easy as 1 2 3? Assembling …
  18. IEEE Transactions on Professional Communication
  19. Applying agile across the IT curriculum
    Information Systems Education Journal
  20. 10.1007/s12599-013-0282-4
  21. Software development using agile and Scrum in distributed teams
    2017 Annual IEEE International Systems Conference (SysCon)
  22. 10.3127/ajis.v27i0.4501
  23. A guidebook for technical communicators in Agile Scrum environments
  24. Toward understanding important workplace issues for technical communicators
    Technical Communication
  25. 10.4324/9781315171418
  26. An integrative literature review of project management in technical and professional comm…
    Technical Communication
  27. 10.1016/j.procs.2019.12.210
  28. Manifesto for Agile Software Development. https://agilemanifesto.org/ Retrieved May 25 2024.
  29. Mathews E. T. (2024). Small Business Online User Documentation: Practices and Priorities (Master's thesis Uni…
  30. 10.1016/j.sbspro.2015.01.1223
  31. Pasuksmit J. Thongtanunam P. Karunasekera S. (2021). Towards just-enough documentation for agile effort estim…
  32. Pelclová J. (2014). Documentation in Agile Development. [Master’s Thesis Masarykova University]. MU Faculty o…
  33. 10.1007/s10664-008-9065-9
  34. Project management: Achieving competitive advantage
  35. 10.1080/87567555.2012.669425
  36. 10.1080/1553118X.2021.1898147
  37. 10.4324/9781315231556
  38. An agile framework for teaching with Scrum in the IT project management classroom
    Journal of Information Systems Education
  39. A case of exhaustive documentation: Re-centering system-oriented organizations around use…
    Technical Communication
  40. Turning obstacles into opportunities: Agile for technical communication
    Intercom
  41. Scrum: The art of doing twice the work in half the time
  42. Tabrez S. Jan I. (2013). Documentation and Agile Methodology. [Master’s Thesis University of Uppsala]. https:…
  43. Adapting to change: Why make plans in an Agile world?
    Intercom
  44. van Loggem B. (2014). Nobody reads the documentation': True or not? Proceedings of ISIC: The Information Beha…
  45. Applications of social research methods to questions in information and library science