Open Advice Book Now Available

{ Posted on Feb 10 2012 by annegentle }
What we wish we had known when we started working on free open source software (FOSS) - that is the premise of this essay collection, Open Advice. What's especially interesting to me after having read all 42 essays is there ...Read More »

Exciting Future for Collaborative Printed Electronic Books

{ Posted on Feb 06 2012 by annegentle }
[vimeo clip_id="36129378" width="400" height="225"] The future of the book is in your hands from Sourcefabric on Vimeo. Sourcefabric builds open source software to support independent media worldwide. On February 14th, we'll announce our tool to help people and organisations write and ...Read More »

Pick a beat for release notes

{ Posted on Jan 23 2012 by annegentle }
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 }
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 »

DocBook, ePub, Hackathon, What More Could You Ask For?

{ Posted on Nov 09 2011 by annegentle }
Tags : , , , , ,
Categories : tools, work, writing
This Friday, on 11/11/11, the Austin Rackspace office is holding a Hackathon. The projects range from "fix the arcade game" to "install notification system to indicate availability of the men's room" to my pet hack project, "create epub output for ...Read More »

Fabric Welding and Costume Making

{ Posted on Nov 02 2011 by annegentle }
Tags : , , ,
Categories : writing
At Rackspace we get these great email threads due to an email list designated for "fun" at each core location. One of these such email threads started with a guy asking if any other guys do sewing - and wondering ...Read More »

Google Summer of Code Doc Summit Stories

{ Posted on Oct 21 2011 by annegentle }
Tags : ,
Categories : social media
On my way to the airport after an intense and enjoyable three day session with four open source projects writing a book apiece, I wonder if I have any more words to write down. The group I worked with had ...Read More »

Wiki Best Practices from Wikia Content Team

{ Posted on Oct 16 2011 by annegentle }
Tags : , ,
Categories : wiki, writing
I found this great set of best practices for wikis on the Wikia site. They host 275,000 wiki sites on all sorts of topics, and truly want to help people reach the most potential with their wiki by offering guidance. ...Read More »

Docs in 2031

{ Posted on Oct 11 2011 by annegentle }
Tags : , , , ,
Categories : work, writing
I like to think about the future of documentation, ruminating on future processes, interactions, and tools. Yet this past week at the OpenStack Conference I was faced with the reality of the future of documentation as a storage device for ...Read More »

Why Wiki?

{ Posted on Sep 28 2011 by annegentle }
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 »