Conversation and Community: The Social Web for Documentation Review

Average Reviews:

(More customer reviews)Anne is a technical writer who has done a considerable amount of work with FLOSS Manuals in documenting the OLPC laptop, and is obviously well-versed in both open-source documentation and social media. The book is designed to give technical writers and other information developers an overview of the tools and techniques available now for documenting products and communicating with end-users through social media and other non-traditional methods.
As a technical writer and community manager, I am exactly the target market for this book, so it is no wonder that I think it is an excellent resource that is long overdue. What surprised me was the depth with which she covered her subjects, the extensive yet highly selective quality of references in the book, and the sheer number of strategies that I hadn't yet encountered even as a professional in this area.
The most important point Anne makes in the book is that documentation as we know it is changing dramatically. Practically all of the basic tenets of technical documentation are in question. Users depend far more often on advice from random strangers via mailing lists, community forums, and search engines than they do on the technical documentation that comes with the product. I have seen this to be true even for highly technical concepts and tools. This is not news to anyone who has ever used Google to find the answer to a technical question rather than looking in the docs, but it was fascinating to see that phenomenon addressed in such a way that my opinions of it were actually changed. Like many technical writers, I have a lingering fear that I will someday be obsolete and that my job of communicating technical issues to users of technology will be taken over by amateurs in ad-hoc communities. Anne gently reminds us that it is the quantity of information that is skyrocketing, not the quality, and that our jobs as technical communicators are more important than ever in making that information "findable", even if that means abandoning what we traditionally think of as documentation. What I took away from this aspect of the book was the overwhelming necessity to make human connections, even in technical documentation, an idea that resonates strongly with my own role as a community builder. Chapter 3 spells it out best as "Defining a Writer's Role with the Social Web".
The book catalogs the available tools and strategies from several different viewpoints based on documentation strategy---in other words, use cases---rather than simply providing an annotated list. Anne specifically points to references and in-the-trenches stories that underscore her points in a very effective way. The subject that brought me the most "aha!" moments was that of wikis. I use wikis on a daily basis, but there were certain aspects of them that I had overlooked. There were so many interesting references in all sections that I felt compelled to stop reading the book and follow them, which is not a criticism of the writing but rather of the sheer amount of information out there. The consistent, confident, professional tone kept me riveted to the book, but I am now going back over every page and following links.
I highly recommend this book to both technical communicators and those involved in social media and community. My copy is going straight to my boss' desk.

Click Here to see more reviews about: Conversation and Community: The Social Web for Documentation

Conversation and Community: The Social Web for Technical Documentation, industry expert Anne Gentle's new book, brings the tools of the Social Web to technical documentation. She looks at the most important Web 2.0 tools, including blogs, wikis, micro-blogging, and syndication, and shows how they can be used to foster conversations and a community with your customers.Through examples and her own hard-won experience with these technologies, Gentle provides practical guidance for technical communicators, marketers, and anyone who wants to use the Social Web to interact with customers.

Click here for more information about Conversation and Community: The Social Web for Documentation