Old Media, Technical Writers, and the Evolution of Documentation

egg-new-life.gifI’ve previously discussed the evolution of technical writing and documentation on this blog, in fact that’s one of the primary topics I tend to orbit around. Regular readers will by now understand my fundamental belief that technical writers are an important and underutilized asset to most businesses; however, I also believe that technical writers have to fundamentally alter the way they approach the problem of educating users and helping them find the answers they need before they will be properly valued by the businesses that employ them.

The ground is shifting in another major industry, old media, caused mostly by the rise of social media and the desire of users to find the news they want online, and there are some interesting parallels that should be considered.


In a recent conversation with Anne Gentle she shared with me some of her thoughts on the future of technical writers and the similarities that might be drawn with the downfall of old media. Quoting from her recent blog post on the topic:

>Previously the best way to get your news was through journalism and your daily newspaper – but the publishing systems have changed and allowed for citizen journalism and news updates through various channels.

>I naturally draw a parallel between citizen journalism and user-generated content. After all, in software, technical writers are like the journalist is – finding the relevant story for a particular audience, interviewing to get the facts, presenting in a fair, nonjudgemental manner, and writing to a deadline.

I think Anne is on to something here. Let’s consider this for a moment.

Journalists help define the debate within a community (most generally, our country). They source, investigate, and write about current news (things the community might find interesting), and the community members (citizens) take the debate and run with it.

Journalism helps create the seeds of modern social debate. Social media helps to highlight the fact that once that seed is planted the journalist, who used to be a position of power to control where the story goes, now becomes much more of a peer to the community–contributing additional thoughts and ideas but with no great advantage to distribute those ideas any more effectively than any other community member.

This is fundamental to the future of technical writers and documentation.

Helping People Learn from other People
————————————–

child-blocks-learn.jpg

Patty Seybold recently wrote an interesting post entitled “People Learn from People”. At the beginning of her post she writes:

>Another pattern I noticed among our Visionaries was the various ways they connect people to people in the online world. As one participant said, “People don’t learn from information; they learn from people.”

Patty goes on to say that a sense of mission to help customers connect with other customers to share and learn from experiences is a critical criteria for companies to make effective use of social media to drive customer acquisition. In my own words, I would suggest that this all goes back to growing happy users.

The Modern Technical Writer
—————————

The enlightened technical writer understands the implications of the downfall of old media and how it relates to user education. They also understand that the ultimate goal of their work product is to build an engine that educates users using not only the words they write, but also the words and experiences of the community. To take Anne’s points and expand on them, here is the description that I believe begins to capture the technical writer of the future:

1. They plant the seeds of discussion by writing answers, not documentation.

2. They publish in a medium that brings users together, ultimately by building a learning community around their company’s content.

3. They understand the documentation is never done and iterate on it as needed by creating new content internally and accepting content from the community.

4. They value, but temper, the wisdom of the crowd to ensure the content is always correct.

5. They are part writer, part community manager, and part user experience advocate for their products.

Newspapers might die but journalism will live on. The value of journalism can never be questioned, but it is clear that the ground is shifting beneath the old media industry. Much the same can be said for technical writing. There will *always* be a need to help users understand how to use products, but there must be a realization that the “old documentation industry” will ultimately wither away entirely. Users are demanding answers in new ways, and writers need to adapt their means of providing that content. Ultimately, a new platform to help technical communicators write, publish, and manage the community debate is needed: social media, blogs, and wikis all provide the fundamental concepts and tools, but taking advantage of them is more easily said than done.

### Let us know what you think!

Got an opinion on the future of the technical publishing industry? Leave a comment and let us know, we want to hear from you!

Technorati Tags: , , , ,

Technorati Tags: , , , ,

-->
  • LisaMonroe
    I guess documentation informations depend of the person who write's it and the level of education he received till that particulary moment.I guess if you reaaly want to find an information you may find it several times in different ways and understands.

    __________________
    Content Writers
  • carolsz
    I love the way you expressed the future of tech writing in The Modern Technical Writer. This job is changing so fast, and being able to articulate this value may help with new job creation.
    I am viewing these changes as a long time "placer" of technical writers. I am happy to share these posts with my community and point them to this blog. Thank you!
  • Carol, thanks very much for your kind words and tweet about the LugIron blog. I'm glad you found it useful enough to share. This is a very fun time to be innovating in the technical communications industry and I hope we'll be able to make a positive impact on the evolution of user education. We'll see!
  • The article was an eye opener for me. Us Indian tech Writiers still pine for the conventional and, might I say, boring methods of documentation. I agree with the fact that people would rather search over the internet, or browse through a forum than to try going through a user guide or search the help section. As the industry and the need for documentation is still at the nascent stages out here, this may take some time to catch up but it will. thanks for the heads up!
  • annegentle
    Hey, thanks for the link and quote! I dashed off that blog entry after reading the Duo blog entry I link to, and once I read the article about the WashPost and HuffPost faceoff I had to draw some parallels to our industry.

    I work with Shannon and he's so very excited about Google Wave. His write-up is great.. I have yet to get all the way through the video from Google, but I do like Read Write Web's write up (http://www.readwriteweb.com/archives/google_wav...) and TechCrunch's article at http://www.techcrunch.com/2009/05/28/google-wav.... I guess I just read first and watch video second. :)
  • evanarsdall
    I believe that Google's Wave platform (http://wave.google.com/) is the future of our industry. Shannon Greywalker apparently does, too. He has summarized the 1.5-hour Google video very effectively in this post: http://greyfiti.com/?p=91. He has also formulated a scenario that I find very plausible.
blog comments powered by Disqus