Everand Logo

Welcome to Everand!

  • Discover millions of ebooks, audiobooks, and so much more with a free trial

    Only $11.99/month after trial. Cancel anytime.

    Unavailable
    Conversation and Community: The Social Web for Documentation
    Unavailable
    Conversation and Community: The Social Web for Documentation
    Unavailable
    Conversation and Community: The Social Web for Documentation
    Ebook493 pages4 hours

    Conversation and Community: The Social Web for Documentation

    By Anne Gentle

    3.5/5

    ()

    Currently unavailable

    Currently unavailable

    About this ebook

    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.

    Inside the Book

    • Towards the Future of Documentation
    • Defining a Writer's Role with the Social Web
    • Community and Documentation
    • Commenting and Connecting with Users
    • Wikis as Documentation Systems
    • Finding Your Voice
    • Content Strategy for Community Documentation NEW Chapter
    • Analyzing and Measuring Web Techniques NEW Chapter
    • Open Source Documentation NEW Chapter
    • Concepts and Tools of the Social Web
    • Glossary, Expanded Bibliography, and Index
    LanguageEnglish
    PublisherXML Press
    Release dateJul 15, 2012
    ISBN9781457182501
    Unavailable
    Conversation and Community: The Social Web for Documentation

    Related to Conversation and Community

    Related ebooks

    Computers For You

    View More
    View More

    Related podcast episodes

    Related articles

    • Article

      Terminal Velocity

      Jun 4, 2019

      Terminal Velocity
      9 min read

    • Article

      Social Media

      Sep 1, 2022

      Social Media
      3 min read

    • Article

      Building Your Brand

      Apr 11, 2022

      Ready to meet and greet at a conference? Your personal branding strategy should include a platform to direct network connections back to—before, during, and after an event. How do you want to be perceived? Your personal brand should be a reflection o

      1 min read

    • Article

      Linux User Groups

      Dec 17, 2019

      Linux User Groups
      1 min read

    • Article

      Letter Of The Month

      Apr 6, 2021

      Letter Of The Month
      1 min read

    • Article

      Building Community

      Dec 21, 2020

      Building Community
      3 min read

    • Article

      Mailserver

      Feb 7, 2023

      Mailserver
      4 min read

    • Article

      The Amnesia Antidote

      Feb 11, 2019

      The Amnesia Antidote
      4 min read

    • Article

      Help And Support

      Nov 17, 2020

      Kali Linux is by far the most documented project of all the distributions on test. Besides the official documentation that mostly deals with the distro, there are several books and lots of online courses that’ll help you become proficient with the bu

      1 min read

    • Article

      Wikipedia

      Apr 7, 2022

      Wikipedia (www.wikipedia.org) is one of the most visited websites on the internet and it’s many people’s go-to site for research. This world’s largest encyclopaedia is hosted by a not-forprofit organisation called Wikimedia Foundation. In January 202

      3 min read

    • Article

      Don’t Let the Tired Win Out

      Dec 21, 2021

      Here are the top five ways to keep your momentum going after a writing conference: 1.Brainstorm ways to apply new concepts before the event even ends. Jot them down, including a timeline, so you can later put your plan into action.2. Review summary s

      1 min read

    • Article

      Sync Or Swim Adobe Spark

      Apr 1, 2018

      I realise that I’ve gotten into a bit of a rhythm with these Sync or Swim columns: the introduction of each could easily be prefaced by ‘I don’t want to go off on a rant, but … ’, and they tend to involve me taking a few jabs at various educational t

      8 min read

    • Article

      Share Your Images

      Oct 19, 2018

      Share Your Images
      2 min read

    • Article

      Documentation And Support

      Jun 4, 2019

      Because Visopsys is primarily designed for developers and students, the bulk of its documentation caters for this group. There’s a lot of information that exposes the internals of the OS, which is a treasure trove for any Computer Science student. Ko

      1 min read

    • Article

      Picture In A Mainframe

      Jul 2, 2019

      Picture In A Mainframe
      11 min read

    • Article

      How To Make The Most Of A Virtual Writing Conference

      Nov 2, 2020

      Events to advance your craft, connections, and career. The reality of the time we’re living in has caused most in-person events to be sidelined until it’s safe for us to again gather in groups. Because the risks of travel and physical interaction are

      7 min read

    • Article

      Software Whiteboards

      Jul 26, 2022

      Software Whiteboards
      1 min read

    • Article

      Zulip Economy

      Oct 20, 2020

      Zulip Economy
      10 min read

    • Article

      Access All Areas

      Feb 1, 2024

      Access All Areas
      6 min read

    • Article

      IBPA Publishing University

      Aug 15, 2020

      IBPA Publishing University
      3 min read

    • Article

      Counting Kroahs

      Jan 14, 2020

      Counting Kroahs
      11 min read

    • Article

      SYNC OR SWIM Rough Animator

      Dec 1, 2019

      SYNC OR SWIM Rough Animator
      11 min read

    Reviews for Conversation and Community

    3.5/5

    3 ratings1 review

    What did you think?

    Tap to rate

    Review must be at least 10 words

    • 4/5
      Anne Gentle has been involved in creating documentation in wikis for awhile now. In the 2009 first edition of Conversation and Community: The Social Web for Documentation, she offered her experiments as a practical guide to persuading management to bring users into your documentation projects. In the expanded second edition, Gentle adds the experiences of other technical communicators to make the case for taking advantage of passionate users to create the best possible docs for your software.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 AnalyticsOne 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