Posts Categorized: Documentation

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 »

OpenStack Documentation Wrap Up for 2013

Posted by & filed under community, Documentation.

It’s that time of the new year to reflect and look for ways to keep improving the OpenStack docs. Here’s a list of major events from 2013 in OpenStack doc-land. Let’s look at the year in review. Operator Guide book sprint was in February 2013 and I still remember it fondly. The before post and… 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 »

To the first OpenStack Documentation BootCamp

Posted by & filed under Communication, community, Documentation, Event.

The OpenStack Docs Bootcamp offers a deep dive into the technical tools, workflows, and processes we use to create docs.openstack.org and api.openstack.org. Our goal is to give enough information that will create sustaining new core members of OpenStack Documentation. Inspired by the first successful Infrastructure BootCamp, the OpenStack Documentation BootCamp is an in-person, intensive sprint… Read more »

OpenStack Security Guide now available!

Posted by & filed under Communication, Documentation.

The legendary book sprint method has come through again! This past week in a bunker, I mean, secure location near Annapolis, a team of security experts got together to write the OpenStack Security Guide. I’m pleased as can be to have the privilege of sharing the epub with you here and now, the evening of… Read more »

Lessons, Learning, and Long Views for Internship Programs

Posted by & filed under community, Development, Documentation, Newsletter, OpenStack Update, Women of OpenStack.

In January 2013 the OpenStack project welcomed aboard three interns and excitedly assigned them to work on fairly complex projects in our first attempt at an organized project-level internship program. The OpenStack Foundation participated as one of the organizations with the GNOME Outreach Program for Women and learned quite a few lessons during the six… Read more »

Introducing the OpenStack Operations Guide

Posted by & filed under community, Documentation, Newsletter, Uncategorized.

Planning to run, or design an OpenStack Cloud?  There’s a new book you should take a look at – the OpenStack Operations Guide.  Get your free download now at http://docs.openstack.org/ops/! You may have already seen the blog post, We Did It: Zero to Book in Five Days, from Anne Gentle, the OpenStack documentation coordinator who came… Read more »

We Did It: Zero to Book in Five Days

Posted by & filed under community, Documentation.

Call me crazy, call me maybe, but we did it! We have a 50,000 word book, 230 pages long, now available for download in your favorite ebook format, or purchase a printed copy if you like the no-batteries-required version. Go to http://docs.openstack.org/ops/ to get a copy and watch a video we made on day four…. Read more »