A book in a week? Yes, a book in a week. It can be done! It’s called a book sprint, and it’s intense. As the documentation coordinator for OpenStack, I knew we’d find the right book to write with this technique. In February, it all came together thanks to generous funding from the OpenStack Foundation for $10,000 to fly the team into our Austin Rackspace location.
Fellow Racker Everett Toews and I assembled a dream team of writers at the OpenStack Summit in October 2012. Many contribute to the OpenStack docs regularly, and Everett had operated clouds with two of them in both Canada and Australia. We hired a book sprint facilitator, Adam Hyde, who has done 55 of these sprints resulting in a book each time.
Day one we had to come up with an example architecture. Why? Because OpenStack gives you a cloud and clouds can be shaped in many configurations. We had a good mix of clouds to pick from. We knew about Rackspace’s Private Cloud offering and its use cases. We had a senior system administrator from MIT who has been running an OpenStack cloud for his researchers in the Computer Science and Artificial Intelligence Lab. We had two cloud architects from Canada and Australia, both running clouds for publicly-funded government projects. The use cases range from those running web servers for web sites to researchers needing real computing power and throughput. The only tiny bit of argument stemmed from choosing the network architecture – should it be multi-host or not? With that civil, gentlemanly arguing out of the way, we churned through sticky notes like there was no end to the stack. We split into two small groups right away to get the outline for an Architecture section and an Operations section. We didn’t quite know what the book would be going in, but by the end of day one, we knew the book we’d write would be the one we needed.
We wrote about 10,000 words a day as a team, resulting in nearly 50,000 words and over 230 pages. The book, OpenStack Operations Guide, is now available at http://docs.openstack.org/ops/, and you can buy a printed copy on Lulu. It’s priced at $29.90, and all the proceeds go to the OpenStack Foundation to fund more community efforts like this one.
We had a ton of help from Rackers in the Austin and San Antonio offices. Thank you Rackers! On Wednesday, day three of the sprint, the Rackspace videographer team of Jacob Forbis and Dennis Weaver made the great video explaining the method to our madness. Take a look, and please read the book and let us know what you think.