Posts Tagged ‘collaboration’

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 »

Must Read: Confluence, Tech Comm, Chocolate

{ Posted on Apr 26 2012 by annegentle }
5 Comments
Tags : , , , ,
Categories : techpubs, wiki, writing
"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 }
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 »

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 »

Why You Might Care about the Cloud

{ Posted on Dec 08 2010 by annegentle }
6 Comments
Tags : , , , ,
Categories : techpubs, tools
Talk about clouds, hybrid clouds, private clouds, and suddenly throw in software as a service and platform as a service, and you might be wondering, what does it mean? Whoa double rainbow, as some would ...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 »

Even More Technical Documentation Wikis

{ Posted on Aug 05 2010 by annegentle }
7 Comments
Tags : , , , , , ,
Categories : techpubs, tools, wiki, writing
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 »

Documenting Open Source Software

{ Posted on May 20 2010 by annegentle }
5 Comments
Tags : , , , , , , , ,
Categories : social media
I love reading different community perceptions of both FLOSS Manuals, where we write open docs for open software. I'm also lurking on mailing lists and forums where open source projects are figuring out documentation needs for their users. Forgive me ...Read More »

Business Etiquette, Community Etiquette

{ Posted on May 18 2010 by annegentle }
8 Comments
Tags : , , , , , ,
Categories : social media
After seeing this great instructional guide to eating sushi, I realized the only way I knew any of the rules or guidelines for sushi dining was through example. I learned that one of my examples was wrong - you're not ...Read More »

Wikis for technical documentation – Cliff’s Notes

{ Posted on Apr 25 2010 by annegentle }
13 Comments
Tags : , , , , , , , ,
Categories : techpubs, tools, wiki
If there ever could be a Cliff's Notes for the wiki chapter of my book, I think I'm writing it now. I've been working on a great project with MindTouch. I visited them for a focus group with other technical ...Read More »
« Older Entries