Archive for the ‘wiki’ Category:

What’s New in Conversation and Community?

{ Posted on Aug 03 2012 by annegentle }
Love this new cover, both photos are Creative Commons licensed once again. Let's look between the covers though! While thinking about the second edition and how three years had passed, I was pleasantly surprised that we could get to the three ...Read More »

Must Read: Confluence, Tech Comm, Chocolate

{ Posted on Apr 26 2012 by annegentle }
"Who cares about printing money, let's print chocolate!" --Chapter 23, Driving Wiki Development, Confluence, Tech Comm, Chocolate Do you need proof that Sarah Maddox, author of Confluence, Tech Comm, Chocolate: A wiki as platform extraordinaire for technical communication, is a complete chocolate ...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 »

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 »

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 »

Observations from the Open Help Conference

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

Working at Rackspace with OpenStack

{ Posted on Sep 10 2010 by annegentle }
Tags : , , ,
Categories : wiki, work
I'm finishing up my first partial week as a "Racker" - that's what employees at Rackspace are called. I'm a special sort of a racker, a stacker, because I've joined the OpenStack team as the OpenStack Technical Writer. My wiki ...Read More »

Even More Technical Documentation Wikis

{ Posted on Aug 05 2010 by annegentle }
Last spring I wrote up a blog entry pointing out some additional technical documentation wikis to add to a list I had in my "Wiki-fy Your Doc Set" presentation. A recent Twitter request asking for technical documentation wiki examples brings ...Read More »

Must Help Pages Live Forever?

{ Posted on Jul 20 2010 by annegentle }
I'm pondering the 1998 article, Pages Must Live Forever (from Jakob Nielson's Alertbox) while documenting the content aging report in MindTouch 2010 (Read the spec here, read the user guide here). With redirects helping stave off link rot, it seems that ...Read More »

Advocate for Community Documentation

{ Posted on May 11 2010 by annegentle }
"Anne, I see you as an advocate for community documentation" - what a great compliment. I was so pleased with the response to my STC Summit talk last week, Strategies for the Social Web for Documentation. Here's the short description ...Read More »