Open Stack

On Jul 26, 2012, at 9:48 AM, Anne Gentle <anne at openstack.org> wrote:

> Hi all -
> I'd like to propose an approach to the organization of the docs site
> centered around three "needs" for readers:
> 
> Compute
> Networking
> Storage
> 
> I believe the benefits of this top-level approach give us reuse of
> content and easier finding of what people seek. It's not a huge
> refactoring since I see it as:
> 
> Compute Administration
> Networking Administration
> Storage Administration
> 
> While these books do exist, the need is in the content itself to be
> modular so it can be shared. For example, the Storage Administration
> guide only describes Object Storage, not Block Storage.
> 

Sounds like a reasonable approach to me. Of course, there will be difficult choices ("Is glance part of Compute or Storage? Where does Keystone go, since it cuts across?") But, like David Weinberger says, "Everything is Miscellaneous". We'll just need to have good cross-reference links across the docs as needed.

> One concern is I don't want to confuse Object Storage (Swift)
> operators by inserting a lot of Volume information where they don't
> need it. But I do believe that we need to round out the coverage of
> documentation.
> 

I think as long as block storage and object storage are clearly delineated, this will be fine. And Ceph crosses block and object storage, so it will have a clear home here.


> This question leads into, how do we document installing and
> configuring networking WITH computing (quantum with nova)? How are
> people getting this information now?
> 

This is something I'd like to know as well. How do you configure quantum? Or how about cinder?


> I'd love some feedback on how to move forward with the addition of
> core projects but the lack of integrated how-to-configure
> documentation. I'll be happy to propose a patch with the refactor, but
> it will mean less patching of Essex, I believe.
> 
> Thanks for your input,
> Anne


I fear we'll probably have to troll through the devstack source. :(


Take care,

Lorin
--
Lorin Hochstein
Lead Architect - Cloud Services
Nimbis Services, Inc.
www.nimbisservices.com





-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20120727/a4d35961/attachment.html>