Posts Tagged ‘openstack’

Who Wrote OpenStack Grizzly Docs?

{ Posted on Apr 26 2013 by annegentle }
No Comments
Tags :
Categories : techpubs, tools, writing
Sneaking a peek at the numbers for documentation along with the code should show us pointers about docs keeping up with code. As I suspected, there were about three major contributors to the operations manuals that span all the projects, ...Read More »

How It’s Made: the OpenStack API Reference Page

{ Posted on Apr 14 2013 by annegentle }
No Comments
Tags :
Categories : community, techpubs, tools, work, writing
Glad you asked! The site at http://api.openstack.org is a collection of HTML pages, and one page has an especially interesting story about how it is built. The http://api.openstack.org/api-ref.html page provides a listing of all the API calls for all OpenStack ...Read More »

Facebook for Social Support? I like.

{ Posted on Jun 01 2012 by annegentle }
3 Comments
Tags : , , , ,
Categories : community, social media, writing
When we first rolled out TryStack, a place for trying out cloud! for OpenStack, we heard the groans from the audience since our first ID check is through a Facebook login. No Facebook, no TryStack. But since we've worked through ...Read More »

Command line reference with true scrolling

{ Posted on Apr 24 2012 by annegentle }
1 Comment
Tags :
Categories : techpubs, writing
I'm at the OpenStack Design Summit this week, and one of the OpenStack companies here, Piston Computing, created a pen that contains a scroll inside. When you open the scroll, you can see all the commands available for the "nova" client, ...Read More »

Open Advice Book Now Available

{ Posted on Feb 10 2012 by annegentle }
4 Comments
Tags : , , , ,
Categories : techpubs, writing
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 »

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 »

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

{ Posted on Nov 09 2011 by annegentle }
4 Comments
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 »

Docs in 2031

{ Posted on Oct 11 2011 by annegentle }
No Comments
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 }
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 »

Observations from the Open Help Conference

{ Posted on Jun 09 2011 by annegentle }
5 Comments
Tags : , , , , , ,
Categories : techpubs, tools, wiki, work, writing
I attended the Open Help Conference in lush, green, over-20-inches-of-rain Cincinnati over the weekend and learned so much. I wanted to share my observations in a longer format than the 140 characters I used sporadically during the conference. First of all, ...Read More »
« Older Entries