On Tue, Sep 3, 2013 at 7:07 AM, Ronen Kat <[email protected]> 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: [email protected] > > > > > From: Emilien Macchi <[email protected]> > To: OpenStack Development Mailing List > <[email protected]>, > Cc: Ronen Kat/Haifa/IBM@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 > // ✉ [email protected] ☎ +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: [email protected] > > > > > > _______________________________________________ > > OpenStack-dev mailing list > > [email protected] > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > [attachment "signature.asc" deleted by Ronen Kat/Haifa/IBM] > _______________________________________________ > OpenStack-dev mailing list > [email protected] > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -- Anne Gentle [email protected]
_______________________________________________ OpenStack-dev mailing list [email protected] http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
