<div dir="ltr"><div>Looks like we all agree that Anne's suggestion is the best approach, so let's go with that.<br><br></div>During the migration period, if a patch is submitted for the Cloud Admin Guide, please ask the contributor to submit the change for both the XML and RST versions of the doc.<br><div><br></div><div>Thanks!<br><br></div><div>Brian<br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On 5 June 2015 at 02:16, Ildikó Váncsa <span dir="ltr"><<a href="mailto:ildiko.vancsa@ericsson.com" target="_blank">ildiko.vancsa@ericsson.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi All,<br>
<br>
We have one patch for Ceilometer now, most probably we will not have that many in the near future, but it would be nice, if we could submit that few. Just to keep the docs contributors eager and motivated. :)<br>
<br>
Thanks,<br>
Ildikó<br>
<span class=""><br>
> -----Original Message-----<br>
> From: Sutton, Harry (HP Converged Systems & Solutions ERT)<br>
> [mailto:<a href="mailto:harry.sutton@hp.com">harry.sutton@hp.com</a>]<br>
> Sent: June 04, 2015 15:59<br>
> To: Brian Moss; Anne Gentle<br>
> Cc: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> Subject: Re: [OpenStack-docs] Freezing Cloud Admin Guide XML<br>
> development<br>
><br>
> Apologies in advance for top-posting, but I couldn't figure out the convention<br>
> from this email ;-) ;-) ;-) so I took the lazy / easy way out.<br>
><br>
> Anyway, as one of the volunteers on this conversion, I don't have any<br>
> problem with the dual approach as long as there isn't a high volume of<br>
> patches submitted (and I wouldn't expect there to be.)<br>
><br>
> My $.02.<br>
><br>
>     /Harry<br>
><br>
> On 06/03/2015 09:45 PM, Brian Moss wrote:<br>
><br>
> On 4 June 2015 at 11:39, Anne Gentle<br>
</span>> <<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>>><br>
<span class="">> wrote:<br>
><br>
><br>
> On Wed, Jun 3, 2015 at 8:04 PM, Brian Moss<br>
</span><span class="">> <<a href="mailto:kallimachos@gmail.com">kallimachos@gmail.com</a><mailto:<a href="mailto:kallimachos@gmail.com">kallimachos@gmail.com</a>>> wrote:<br>
> Hi all,<br>
><br>
> We're kicking off the conversion of the Cloud Admin Guide from XML to RST<br>
> (<a href="https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Gu" target="_blank">https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Gu</a><br>
</span>> ide_Migration).  While we're doing this, we'd like to put a temporary freeze<br>
<div><div class="h5">> on development of the guide so we don't have the XML changing beneath<br>
> us.  To this end, could everyone please hold off on making changes to the<br>
> Cloud Admin Guide until we announce the conversion is complete.<br>
><br>
><br>
> Hi Brian,<br>
><br>
> One thing we did due to the long migration times for the user guides was to<br>
> request a change to both the XML and RST in any patchset during the<br>
> migration period. There weren't too many of those, but you may consider it<br>
> for the time period so the freeze isn't preventing improved content in the<br>
> meantime.<br>
><br>
> Since we needed 3 months to migrate the other two guides (mid-Feb to mid-<br>
> May), and this release is only 5.5 months, you should probably try either not<br>
> to freeze or to migrate more quickly.<br>
><br>
> Just a consideration based on past experience -- you may have already found<br>
> a way to migrate more content quickly.<br>
> Thanks,<br>
> Anne<br>
><br>
><br>
> Hi Anne,<br>
><br>
> That's a good idea.  I'm feeling my way somewhat here, so having the benefit<br>
> of past experience is much appreciated.<br>
><br>
> User Guide team et al., how do you feel about requesting XML and RST for<br>
> patches while we're doing the migration rather than freezing the doc?<br>
><br>
> -Brian<br>
><br>
><br>
><br>
><br>
> If you happen to find yourself reviewing an XML Cloud Admin Guide patch in<br>
> the next few weeks, please let the author know about the freeze and ask<br>
> them to resubmit an RST patch when the conversion is finished.<br>
><br>
> Thanks!<br>
><br>
> Brian<br>
><br>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
</div></div>> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><mailto:<a href="mailto:OpenStack-">OpenStack-</a><br>
> <a href="mailto:docs@lists.openstack.org">docs@lists.openstack.org</a>><br>
<span class="">> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
><br>
><br>
><br>
><br>
> --<br>
> Anne Gentle<br>
</span>> <a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>><br>
><br>
><br>
><br>
><br>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><mailto:<a href="mailto:OpenStack-">OpenStack-</a><br>
> <a href="mailto:docs@lists.openstack.org">docs@lists.openstack.org</a>><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<div class="HOEnZb"><div class="h5">><br>
><br>
><br>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br></div>