07 Oct
Posted by Scott as advice, authoring, content, technical communication, users
That’s what you’re doing when you write documentation, marketing collateral, Web content, articles, or whatever your deliverable is. Freelance writer Bruce Byfield examines this in detail in a post on his blog. Admittedly, Byfield is talking about general non fiction or even fiction writing, but the lessons he imparts in that post can be applied to technical communication as well.
Byfield writes the following about his initial experience as a writing teacher:
When I first stepped in front of a class, I imagined that I fully controlled the experience. As a result, my first semester teaching post-secondary was almost my last. I needed to learn that, while some students wanted to learn, I needed to cajole or entertain others before they would even try to absorb my lesson.
Substitute readers or users for students and you probably understand fully what Byfield is getting at. The people reading your material want to learn — about your company’s products and services, about how to use those products, about how to quickly solve the problems that they encounter.
With documentation, you can collaborate with the user on two levels:
How do you currently, or plan to, collaborate with your readers? Or is this even in the cards for you? Feel free to leave a comment.
Related posts:
RSS feed for comments on this post · TrackBack URI
Leave a reply