Effective documentation requires you to have empathy for your users, which you can build with user research and its tools: interviews, developer surveys, and reviewing support issues. This chapter describes how to conduct research and condense your research into user personas, user stories, and user journey maps that you can refer to later. Empathize with your users by trying out your own software and documenting your experience in a friction log. Notice the places in your product where you can help your users through documentation or through product improvements.
This is a preview of subscription content, access via your institution.
Colin Camerer, George Loewenstein, Martin Weber, “The Curse of Knowledge in Economic Settings: An Experimental Analysis,” Journal of Political Economy, Vol. 97 no. 5.
Elizabeth Louise Newton Ph.D., “The Rocky Road From Actions to Intentions,” Stanford University, 1990, 33–46.
Maria Rosala, “Ethical maturity in user research,” Nielsen Norman Group, published December 29, 2019, www.nngroup.com/articles/user-research-ethics/.
Jakob Nielsen, “Why you only need to test with 5 users,” Nielsen Norman Group, published March 18, 2000, www.nngroup.com/articles/why-you-only-need-to-test-with-5-users/.
Jakob Nielsen, “Keep online surveys short,” Nielsen Norman Group, published February 1, 2004, www.nngroup.com/articles/keep-online-surveys-short/.
Gerry Gaffney and Caroline Jarrett, Forms that work: Designing web forms for usability (Oxford: Morgan Kaufmann, 2008), 11–29.
Rights and permissions
© 2021 The Author(s), under exclusive license to APress Media, LLC, part of Springer Nature
About this chapter
Cite this chapter
Bhatti, J., Corleissen, Z.S., Lambourne, J., Nunez, D., Waterhouse, H. (2021). Understanding your audience. In: Docs for Developers. Apress, Berkeley, CA. https://doi.org/10.1007/978-1-4842-7217-6_1
Publisher Name: Apress, Berkeley, CA
Print ISBN: 978-1-4842-7216-9
Online ISBN: 978-1-4842-7217-6
eBook Packages: Professional and Applied ComputingProfessional and Applied Computing (R0)Apress Access Books