Auf ein Miniaturbild klicken, um zu Google Books zu gelangen.
Lädt ... Conversation and Community: The Social Web for Documentationvon Anne Gentle
Keine Lädt ...
Melde dich bei LibraryThing an um herauszufinden, ob du dieses Buch mögen würdest. Keine aktuelle Diskussion zu diesem Buch. keine Rezensionen | Rezension hinzufügen
Anne Gentle's Conversation and Community has become the go-to reference for social media and technical communication. Her clear-eyed survey of the social media landscape has been adopted by many universities and is widely used by technical communicators. Now, in this second edition, she has updated and expanded her book, adding chapters on building a content strategy, analyzing web techniques, and developing an open source strategy. With more interviews and case studies, this is your guide to the new world of technical communication and social media. Keine Bibliotheksbeschreibungen gefunden. |
Aktuelle DiskussionenKeine
Google Books — Lädt ... GenresKlassifikation der Library of Congress [LCC] (USA)BewertungDurchschnitt:
Bist das du?Werde ein LibraryThing-Autor. |
Collaboration and teamwork is nothing new, either for software developers or technical communicators. One benefit that the free software movement has given all of us is the idea thaollaboration in his 1996 essay, “The Cathedral and the Bazaar.” Perhaps the best known of these rules was borrowed from Linus Torvalds, the founder of the Linux operating system. Raymond wrote: “Given a large enough beta-tester and co-developer base, almost every problem will be characterized quickly and the fix obvious to someone. Or, less formally, ‘Given enough eyeballs, all bugs are shallow.’”
Gentle argues that the same principle can be applied to product documentation. “Documentation as conversation means getting closer to user and helping them perform well,” she writes. “Now, writers can take the idea of user-centered design a step further by starting conversations with users and enabling user assistance in interactions.”
The book covers how to get started in identifying the best ways to begin the conversation with users, whether it’s a wiki, blog, web-based forum, or even Twitter. She also gives guidelines for selecting platforms.
Better Product Documentation with Book Sprints, Content Strategy and Analytics
One of my favorite sections is the discussion of “book sprints,” pioneered by the FLOSS Manuals project. In a book sprint, normally widely-scattered developers, writers and users come together for a few days to create or update a set of docs for an open source project. Gentle explains how to plan and carry out a successful book sprint, factoring in all the costs and logistics of the project.
The second edition offers new chapters focusing on content strategy, using web analytics to discover more about your users and what they seek help with, and the process of documenting open source software. You’ll learn about content and community audits, how to build a community of users, and how to participate in open source documentation projects.
Besides Gentle’s own experience building conversation and community with a variety of organization, this edition is informed with interviews and case studies from tech writers at companies like AutoDesk, IBM, Red Hat and Embarcadero.
The book does have some organizational issues. At times, I was not sure whether I was reading about early experiments with social documentation, making a business case, or already into implementing a social strategy. Nonetheless, Gentle consistently addresses the business value of documentation generally, and social documentation as pointing to the future of software documentation.
Conversation and Community is an excellent introduction to the value of bringing in users to your user assistance toolkit, and will help you overcome management resistance to implementing a social strategy. You can also learn how to get involved in open source documentation projects, especially if you’re new to our profession.
Appeared on TechWhirl.com on October 24, 2012 ( )