Just Write Click

Technical writing with Continuous Integration and docs-as-code

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code
You are here: Home / social media / The why and how of writing a book

August 12, 2009 by annegentle

The why and how of writing a book

I’ve been asked a few times, why did you write this book? And often it’s paired with, how did you write this book? I think I answer both questions in this interview I just completed with Emmelyn Wang on the stcaustin.org site. Here’s an excerpt, but you can click through to read more.

STC Austin: In addition to your love of reading books and your desire to teach/learn, what other motivations compelled you to author Conversation and  Community: The Social Web for Documentation?

Anne Gentle: I felt compelled to write this book to capture this point in time – a time when user-created content is getting enough notice for Time magazine to name the person of the year “You.” As a wiki writer working on the open source education projects for One Laptop per Child and SugarLabs, I was seeing technical writing in a new light and I wanted to chronicle my experiences. Writing content that could be commented on and edited by other community members was different from a traditional technical writing role. Writing blog entries as a technical writer representing BMC Software was also rather unusual at the time I was doing it, in fall of 2005. We were working on the talk.bmc.com site because of a belief in the Cluetrain Manifesto.

Often I outlined or wrote sections of the book rather than write a blog entry twice a week. Little by little it formed into a book, with the help of Kelly Holcomb, my good friend and editor who would read the sections, ask questions to fill in the gaps, and stitch it together. I also am in debt to the writing communities and writers that gave me the experiences from which I gathered tales as examples. I wanted it to be in book format to reach a different audience than my typical blog readers. I wanted the book format to give more credibility to the premise that the social web is important enough that just another blog writing about it wasn’t enough, that the value here was enough for a publisher to invest in it. XML Press is the perfect publisher for that, because it provides content that helps technical communicators be more effective in their work and value proposition. What better value proposition can we provide than to get closer to our customers, understanding their needs and responding to them quickly.

Read more…

Related

Filed Under: social media Tagged With: presentation, slides, social media, social networking, STC, stc09, technical writing, techpubs, wiki

More reading

Bubble graph showing sources of developer support data

I’ve been thinking a lot about developer support at Cisco recently, especially for the way the world works today with multiple cloud providers. This post is a re-publish of my talk from over five years ago, but the techniques and tools for listening and helping others are still true today. At Rackspace, we watched several […]

Cisco DevNet is our developer program for outreach, education, and tools for developers at Cisco. From the beginning, the team has had a vision for how to run a developer program. Customers are first, and the team implements what Cisco customers need for automation, configuration, and deployment of our various offerings. Plus, the DevNet team […]

I had a great talk with Ellis Pratt of Cherryleaf Technical Writing consulting last week. Here are the show notes, full of links to all the topics we covered. Podcasts are great fun to listen to and participate in, if a bit nerve-wracking to think on your feet and make sure you answer questions succinctly […]

At the beginning of this year, I worked hard to summarize my thoughts on API documentation, continuous publishing, and technical accuracy for developer documentation. The result is an article on InfoQ.com, edited by Deepak Nadig, who also was forward-thinking in having me speak to a few teams at Intuit about API documentation coupled with code. Always […]

Recently on Just Write Click

  • A Flight of Static Site Generators: Sampling the Best for Documentation
  • Try a GPT about “Docs Like Code” to ask questions
  • Discipline and Diplomacy: Docs in the Open
  • Let’s Find Out: When Do Static Site Generators Do Rendering?
  • GitHub for Managing Tech Docs

Just Write Click in your Inbox

Enter your email address to subscribe to Just Write Click and receive notifications of new posts by email.

Read More

  • Privacy Policy
  • About Anne Gentle, developer experience expert
  • Books by Anne Gentle
    • Conversation and Community
    • Docs Like Code, a Book for Developers and Tech Writers
  • Woman in Tech Speaker Profile
  • Contact

Books

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code

Copyright © 2025 · WordPress · Log in