Evaluating the user experience of documentation -- Podcast with Bob Watson
You can listen to the podcast here:
Listen here:
Here are a few questions we cover during the podcast:
- Should tech writers do user testing and research, or is this product team’s job in designing the product?
- Can’t we just leverage marketing personas for the user research we need?
- How can looking at the market and product angles help clarify user needs and behaviors?
- What kind of knowledge can we leverage from universal design patterns about how users consume docs?
- How do we avoid hasty generalizations from a user sample that’s too small?
- Is it feasible for tech writers to actually do user testing on top of all of their other duties?
- How can you make feedback forms on docs more likely to get responses from users?
- If you collect feedback at major milestones that users complete, how do you avoid just collecting responses from successful users?
- How does Twilio successfully collect info from their users?
- How can you successfully gather metrics that show user success or failure on tasks?
- How can you make your feedback surveys specific to the data so that you get better responses?
For more information about Bob Watson, see his site, Docs by Design.
Sponsored
About Tom Johnson
I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, agent skills, tech comm careers, and more. Check out my AI courses for more on the latest in AI and tech comm. If you're looking for info about documenting APIs, see my API documentation course.
If you're a technical writer and want to keep on top of the latest trends in tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me.
Finally, I want to note a couple of things. I usually write the first drafts of my posts myself and then use AI to improve accuracy, clarity, and detail in places, so my writing is a mix of human and AI. (Hopefully that's not too off-putting.) Also, the opinions I express on my blog are my own perspectives, not those of my employer.