Open Stack

On Tue, Sep 3, 2013 at 7:07 AM, Ronen Kat <RONENKAT at il.ibm.com> wrote:

> Hi Emilien,
>
> I have looked at the block guide - the master branch it is mostly empty,
> most of the content was moved to the OpenStack configuration reference.
> Any suggestion on relation what should be in the configuration reference
> vs. the block admin guide - which is now practically empty.
>
>
Yes, your observations are accurate.

The Admin manuals are for day-to-day operations and running block storage.
The Config Reference is for one-time configuration and tuning. We have been
discussing these changes on the -dev mailing list. [1]

So, here are the placements:

1. Backup configuration

Configuration Reference

2. General description of Cinder backup (commands, features, etc)

Block Storage Administration Guide

3. Description of the available backup drivers

Configuration Reference

I believe this is the best for our audience.

Thanks,
Anne

[1]
http://lists.openstack.org/pipermail/openstack-dev/2013-August/013347.html



> Regards,
> __________________________________________
> Ronen I. Kat
> Storage Research
> IBM Research - Haifa
> Phone: +972.3.7689493
> Email: ronenkat at il.ibm.com
>
>
>
>
> From:   Emilien Macchi <emilien.macchi at enovance.com>
> To:     OpenStack Development Mailing List
>             <openstack-dev at lists.openstack.org>,
> Cc:     Ronen Kat/Haifa/IBM at IBMIL
> Date:   03/09/2013 02:57 PM
> Subject:        Re: [openstack-dev] Cinder Backup documentation - to which
> doc
>             it should go?
>
>
>
> Hi Ronen,
>
> The best place for your documentation is in the OpenStack Bloc Storage
> guide [1].
> If you need help with OpenStack manuals, we have a dedicated wiki page [2].
>
> Please let us know if you need support.
>
>
> Regards,
>
> [1]
>
> https://github.com/openstack/openstack-manuals/tree/master/doc/src/docbkx/openstack-block-storage-admin
>
> [2] https://wiki.openstack.org/wiki/Documentation/HowTo
>
> Emilien Macchi
> ----------------------------------------------------
> # OpenStack Engineer
> // eNovance Inc.              http://enovance.com
> // ✉ emilien at enovance.com     ☎ +33 (0)1 49 70 99 80
> // 10 rue de la Victoire 75009 Paris
>
> On 09/03/2013 12:50 PM, Ronen Kat wrote:
> >
> > I noticed the complains about code submission without appropriate
> > documentation submission, so I am ready to do my part for Cinder
> backup....
> > I have just one little question.
> > Not being up to date on the current set of OpenStack manuals, and as I
> > noticed that the block storage admin guide lost a lot of content, to
> which
> > document(s) should I add the Cinder backup documentation?
> >
> > The documentation includes:
> > 1. Backup configuration
> > 2. General description of Cinder backup (commands, features, etc)
> > 3. Description of the available backup drivers
> >
> > Should all three go to the same place? Or different documents?
> >
> > Thanks,
> >
> > Regards,
> > __________________________________________
> > Ronen I. Kat
> > Storage Research
> > IBM Research - Haifa
> > Phone: +972.3.7689493
> > Email: ronenkat at il.ibm.com
> >
> >
> > _______________________________________________
> > OpenStack-dev mailing list
> > OpenStack-dev at lists.openstack.org
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
>
> [attachment "signature.asc" deleted by Ronen Kat/Haifa/IBM]
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>



-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130903/28d1706b/attachment.html>