What’s next for application developer guides?

Posted by & filed under Development, Documentation, Tools.

Summary This month, the developer.openstack.org site gets a new look and changes its source tooling. Read on for details about how these changes affect your project team. Why are we changing the developer.openstack.org site? You might know that the developer.openstack.org site documents over 900GET/PUT/POST/DELETE/PATCH calls for a dozen OpenStack services already on the developer.openstack.org site. As a couple of… Read more »

How to Use Ask OpenStack

Posted by & filed under community, Documentation.

We’re continuously building together “The best place on the Internet to find answers to common OpenStack problems”: our Question&Answers site Ask OpenStack is such place and needs everybody’s help. Ask OpenStack is a collaborative effort, think of it like a wiki where pages are made only of questions and answers. Anybody with more than 100… Read more »

Starter docs and articles

Posted by & filed under community, Development, Documentation.

I wanted to send a note out to discuss the growth of all the starter docs and “articles” on a particular topic. Thanks all who are sending these as links to the mailing list or tweeting ’em. We are listening. The doc team has been discussing ways to ensure we help people find what they… Read more »

Under the hood of Swift: the Ring

Posted by & filed under Documentation.

This is the first post in series that summarizes our analysis of Swift architecture. We’ve tried to highlight some points that are not clear enough in the official documentation. Our primary base was an in-depth look into the source code. The following material applies to version 1.4.6 of Swift. The Ring is the vital part… Read more »

Documentation Contributors Styling Ts

Posted by & filed under community, Documentation.

Why give your time and efforts to an online community? Researchers like Peter Kollock have identified and studied reasons for people to contribute to online communities. I try to keep the basic principles of online participation in mind for documentation contributors all the time, and find ways to recognize the people making a difference with… Read more »

OpenStack Documentation Blitz

Posted by & filed under Documentation.

I had a great idea come across my radar this week – a Documentation Blitz! I’ve been working on case studies for a second edition of my book, Conversation and Community: The Social Web for Documentation, and in one of the case studies from Sarah Maddox at Atlassian, I uncovered a gem of an idea…. Read more »

Documentation Wrangling and Statistics Sharing

Posted by & filed under Documentation, Measurement, Website.

I’ve been tracking web analytics on the documentation site since we put it up in February, and I thought I’d share some of the more interesting nuggets of data I’ve mined. I believe the documentation statistics offer a crystal ball, a window showing the future of what’s up-and-coming for OpenStack. Let’s gaze together. The docs.openstack.org… Read more »

Dedicated Doc Day

Posted by & filed under Documentation, Event.

Rather than having a doc sprint session at the upcoming Summit, I’ve decided to do a push for docs for Cactus with a single two dedicated doc days this Wednesday, April 6th, and Wednesday, April 13th. I’d like to get us all on the same page with this post. (Ha, page.) I track my doc… Read more »