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 »
Posts Tagged: documentation
How to Use Ask OpenStack
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 »
Bring on the Crazy: Zero to Book in Five Days
Well, since my team mate Everett has outed me as crazy (yes, it’s true), I think I’ve got some ‘splaining to do! It’s true, we’re crazy, but we’ve got to write that operator’s guide — for operators by operators. And if you know ops folks like I do, you realize quickly that these guys have… Read more »
OpenStack Community Weekly Newsletter (Oct 12-19)
Highlights of the week Coverage of OpenStack Summit This was a busy week for all of OpenStack members. A few reports from the community: OpenStack Summit: Day 1 OpenStack Summit Day 1 Blog A list of announcements from day 1 From the Ground at the OpenStack Summit Keynotes Recap from Day 2: OpenStack in production… Read more »
Starter docs and articles
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
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
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
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
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
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 »