<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Sep 3, 2013 at 7:07 AM, Ronen Kat <span dir="ltr"><<a href="mailto:RONENKAT@il.ibm.com" target="_blank">RONENKAT@il.ibm.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Hi Emilien,<br>
<br>
I have looked at the block guide - the master branch it is mostly empty,<br>
most of the content was moved to the OpenStack configuration reference.<br>
Any suggestion on relation what should be in the configuration reference<br>
vs. the block admin guide - which is now practically empty.<br>
<div class="im"><br></div></blockquote><div><br></div><div>Yes, your observations are accurate. </div><div><br></div><div>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]</div>
<div><br></div><div>So, here are the placements:</div><div><br></div><div><span style="font-family:arial,sans-serif;font-size:13px">1. Backup configuration</span></div><div><br></div><div>Configuration Reference</div><div>
<br style="font-family:arial,sans-serif;font-size:13px"><span style="font-family:arial,sans-serif;font-size:13px">2. General description of Cinder backup (commands, features, etc)</span></div><div><br></div><div>Block Storage Administration Guide</div>
<div><br><span style="font-family:arial,sans-serif;font-size:13px">3. Description of the available backup drivers</span><br></div><div><br></div><div>Configuration Reference</div><div><br></div><div>I believe this is the best for our audience. </div>
<div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div>[1] <a href="http://lists.openstack.org/pipermail/openstack-dev/2013-August/013347.html">http://lists.openstack.org/pipermail/openstack-dev/2013-August/013347.html</a></div>
<div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class="im">
Regards,<br>
__________________________________________<br>
Ronen I. Kat<br>
Storage Research<br>
IBM Research - Haifa<br>
Phone: <a href="tel:%2B972.3.7689493" value="+97237689493">+972.3.7689493</a><br>
Email: <a href="mailto:ronenkat@il.ibm.com">ronenkat@il.ibm.com</a><br>
<br>
<br>
<br>
<br>
</div>From: Emilien Macchi <<a href="mailto:emilien.macchi@enovance.com">emilien.macchi@enovance.com</a>><br>
To: OpenStack Development Mailing List<br>
<<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>>,<br>
Cc: Ronen Kat/Haifa/IBM@IBMIL<br>
Date: 03/09/2013 02:57 PM<br>
Subject: Re: [openstack-dev] Cinder Backup documentation - to which doc<br>
it should go?<br>
<div><div class="h5"><br>
<br>
<br>
Hi Ronen,<br>
<br>
The best place for your documentation is in the OpenStack Bloc Storage<br>
guide [1].<br>
If you need help with OpenStack manuals, we have a dedicated wiki page [2].<br>
<br>
Please let us know if you need support.<br>
<br>
<br>
Regards,<br>
<br>
[1]<br>
<a href="https://github.com/openstack/openstack-manuals/tree/master/doc/src/docbkx/openstack-block-storage-admin" target="_blank">https://github.com/openstack/openstack-manuals/tree/master/doc/src/docbkx/openstack-block-storage-admin</a><br>
<br>
[2] <a href="https://wiki.openstack.org/wiki/Documentation/HowTo" target="_blank">https://wiki.openstack.org/wiki/Documentation/HowTo</a><br>
<br>
Emilien Macchi<br>
----------------------------------------------------<br>
# OpenStack Engineer<br>
// eNovance Inc. <a href="http://enovance.com" target="_blank">http://enovance.com</a><br>
// ✉ <a href="mailto:emilien@enovance.com">emilien@enovance.com</a> ☎ <a href="tel:%2B33%20%280%291%2049%2070%2099%2080" value="+33149709980">+33 (0)1 49 70 99 80</a><br>
// 10 rue de la Victoire 75009 Paris<br>
<br>
On 09/03/2013 12:50 PM, Ronen Kat wrote:<br>
><br>
> I noticed the complains about code submission without appropriate<br>
> documentation submission, so I am ready to do my part for Cinder<br>
backup....<br>
> I have just one little question.<br>
> Not being up to date on the current set of OpenStack manuals, and as I<br>
> noticed that the block storage admin guide lost a lot of content, to<br>
which<br>
> document(s) should I add the Cinder backup documentation?<br>
><br>
> The documentation includes:<br>
> 1. Backup configuration<br>
> 2. General description of Cinder backup (commands, features, etc)<br>
> 3. Description of the available backup drivers<br>
><br>
> Should all three go to the same place? Or different documents?<br>
><br>
> Thanks,<br>
><br>
> Regards,<br>
> __________________________________________<br>
> Ronen I. Kat<br>
> Storage Research<br>
> IBM Research - Haifa<br>
> Phone: <a href="tel:%2B972.3.7689493" value="+97237689493">+972.3.7689493</a><br>
> Email: <a href="mailto:ronenkat@il.ibm.com">ronenkat@il.ibm.com</a><br>
><br>
><br>
> _______________________________________________<br>
> OpenStack-dev mailing list<br>
> <a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br>
<br>
</div></div>[attachment "signature.asc" deleted by Ronen Kat/Haifa/IBM]<br>
<div class=""><div class="h5">_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>