[Openstack-docs] Intro and example installations

Shaun McCance shaunm at gnome.org
Thu Jul 18 15:40:19 UTC 2013


Hi all,

I want to ask the list for input on example installations of OpenStack.
But since I've failed to introduce myself to the list, let me do that.

I've been doing open source documentation for GNOME for a long time.
In fact, this September I will have been the GNOME docs team lead for
ten years. I also run the Open Help Conference each year, which is how
I met Anne. I do freelance documentation work as a day job. Currently,
I'm doing upstream OpenStack documentation work under contract with
Cisco, working on the installation guides.

What I'd like to do is compile a list of example deployments that we
can use to guide and evaluate the installation docs. Obviously, it
can't be comprehensive, given how flexible OpenStack is. Thinks of
personas, except configurations instead of people.

Does anybody have any real-world cases they can distill into examples?
Ideally we'd have half a dozen example setups: how many nodes, what's
running on what, etc. More importantly, why was OpenStack set up this
way, what advantages does it have, and what are the drawbacks.

My general plan is to have a single installation guide, with the first
couple chapters providing the simplest evolvable installation, and the
rest being a sort of choose-your-own-adventure on adding to that basic
installation. Having example setups would help a lot in getting the
structure right.

Thanks,
Shaun





More information about the Openstack-docs mailing list