Three types of knowledge every technical writer needs to be successful
I’ve illustrated the three types of knowledge in the following diagram.
When you combine technical knowledge, product knowledge, and user knowledge, you become a key player in your organization. Usually engineers dominate the technical, product managers dominate the product, and support dominates the users. Technical writers need to a decent understanding of all three of these domains to write useful documentation.
Here’s a little more detail about each type of knowledge:
- Product knowledge: A solid understanding of the product. You get this information usually by reading the company wiki, roadmaps, sprint items, and other domains where product managers and others write specfically about the product.
- Technical knowledge: A strong understanding of the technical details needed to be successful in this domain, such as an understanding of a programming language or platform. Java, Android, PHP, and so on.
- User knowledge: An understanding of user questions, issues, complaints, requests, and other feedback. You often acquire this knowledge by reading forum threads, looking at support logs, attending trainings, or other interactions.
I know that just writing docs, you pick up this knowledge. But you can also purposely turn up the dial by putting in “extra” time in all three of these areas.
Additionally, these three areas of knowledge feed off each other. If you want to ramp up on technical knowledge (say, by learning Android), there is simply too much to cover by just reading how-to books on Android. You may spend weeks learning about features that no user cares about, and which are irrelevant to your product. By understanding user questions and issues, you can more accurately focus your deep dives into technical and product knowledge, and vice versa.
Ideally, I’d like to test out my hypothesis about the importance of this knowledge by dialing up my expertise in these three areas over the long term.
I'd Rather Be Writing Newsletter
Get new posts delivered straight to your inbox.
About Tom Johnson
I'm a technical writer based in the California San Francisco Bay area. In this blog, I write about topics related to technical communication — Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, academics, and more. I'm interested in simplifying complexity, API documentation, visual communication, information architecture and findability, and more. If you're a technical writer of any kind (progressional, transitioning, student), be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.