Posts Tagged ‘documentation’

Choose Conversation and Community

{ Posted on Jul 22 2012 by annegentle }
1 Comment
Tags : , , , , , ,
Categories : social media
We're closing in on the second edition of my book being released and available! I'm super excited about it. I can't stop thinking about it. On the way back from the O'Reilly Open Source Convention, I started doodling in a ...Read More »

Pick a beat for release notes

{ Posted on Jan 23 2012 by annegentle }
5 Comments
Tags : , , ,
Categories : techpubs, wiki, writing
This is fun. Fedora has "beat writers" which harken to journalists tracking a story. Each beat is a section in the release notes. I found it while poking around on the Fedora wiki pages that describe how they do documentation. ...Read More »

From Cement to Spandex – Making PDF and ePub

{ Posted on Dec 02 2011 by annegentle }
No Comments
Tags : , , ,
Categories : techpubs, tools, work, writing
Which statement is true: "PDFs are like cement." or "Gentlemen prefer PDF." Turns out both are true! See my recent OpenStack blog entry, Hacking on Ebooks, for more context and attributions for those statements. We recently held a hackathon which I blogged about earlier to ...Read More »

Why Wiki?

{ Posted on Sep 28 2011 by annegentle }
4 Comments
Tags : , , , , , , , , , , , , ,
Categories : techpubs, wiki
In OpenStack-land, the wiki was chosen before I got here. It has a couple of flaws for my vision for open source documentation, which became more apparent when I recently outlined my reasoning for what content goes where. By walking ...Read More »

Social Support and Documentation Communities

{ Posted on Jul 14 2011 by annegentle }
1 Comment
Tags : , , , ,
Categories : social media, techpubs, tools
Stories of Social Media Sticking in Unlikely Places Saying, "No one reads the manual" just doesn't hold water any more. Social technology has intersected even the classic user manual. There's always someone who will read a book. But their true motivation ...Read More »

Trends and Open Source Writing

{ Posted on Mar 09 2011 by annegentle }
1 Comment
Tags : , , ,
Categories : social media, work, writing
I get the greatest emails sometimes, thanks to my blog. Here's the lead-in line that especially piqued my interest: "I'm researching trends in technical communication for a grad-level writing class," She had me at trends in technical communication. And research. So of ...Read More »

Open Help is Open

{ Posted on Jan 14 2011 by annegentle }
1 Comment
Tags : , ,
Categories : techpubs, tools
The tech writers who are established, recognized figures in open source you can probably count on your fingers and toes. About two years ago they gathered for the Writing Open Source conference, hosted by Emma Jane Hogbin. I couldn't attend ...Read More »

OpenStack Doc Sprinting

{ Posted on Nov 23 2010 by annegentle }
1 Comment
Tags : , , , , ,
Categories : techpubs, tools, work
What a week! I'm recovered and finally able to reflect on our recent OpenStack Design Summit. As you may have seen on the OpenStack Blog, we gave out three documentation awards to those who made a difference in the latest OpenStack ...Read More »

Agile Across the Enterprise

{ Posted on Dec 11 2009 by annegentle }
No Comments
Tags : , , , , , , ,
Categories : social media
As a guest post on The Agile Executive blog, I was invited by Israel Gat to describe book sprints as an Agile method for documentation. Here is the beginning of the post and I encourage you to read the rest ...Read More »

Twitter and conversation analysis – who’s here?

{ Posted on Oct 26 2009 by annegentle }
7 Comments
Tags : , , , , ,
Categories : social media
"Hoosier," the somewhat odd name for a native from Indiana, may have its roots in conversation. One of the stories is that when a knock from someone at the door rang out, the person inside would ask, "Who's here?" and ...Read More »
« Older Entries