<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On 4 June 2015 at 11:39, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Wed, Jun 3, 2015 at 8:04 PM, Brian Moss <span dir="ltr"><<a href="mailto:kallimachos@gmail.com" target="_blank">kallimachos@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div><div>Hi all,<br><br></div>We're kicking off the conversion of the Cloud Admin Guide from XML to RST (<a href="https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration" target="_blank">https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration</a>).  While we're doing this, we'd like to put a temporary freeze on development of the guide so we don't have the XML changing beneath us.  To this end, could everyone please hold off on making changes to the Cloud Admin Guide until we announce the conversion is complete.<br></div></div></div></blockquote><div><br></div><div><br></div></span><div>Hi Brian,</div><div><br></div><div>One thing we did due to the long migration times for the user guides was to request a change to both the XML and RST in any patchset during the migration period. There weren't too many of those, but you may consider it for the time period so the freeze isn't preventing improved content in the meantime. </div><div><br></div><div>Since we needed 3 months to migrate the other two guides (mid-Feb to mid-May), and this release is only 5.5 months, you should probably try either not to freeze or to migrate more quickly. </div><div><br></div><div>Just a consideration based on past experience -- you may have already found a way to migrate more content quickly.</div><div>Thanks,</div><div>Anne</div></div></div></div></blockquote><div><br><br><div>Hi Anne,<br><br></div><div>That's a good idea.  I'm feeling my way somewhat here, so having the benefit of past experience is much appreciated.<br><br></div><div>User
 Guide team et al., how do you feel about requesting XML and RST for 
patches while we're doing the migration rather than freezing the doc?<br><br></div>-Brian<br><br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class=""><div dir="ltr"><div><div><br>If you happen to find yourself reviewing an XML Cloud Admin Guide patch in the next few weeks, please let the author know about the freeze and ask them to resubmit an RST patch when the conversion is finished.<br><br></div>Thanks!<span><font color="#888888"><br><br></font></span></div><span><font color="#888888">Brian<br></font></span></div>
<br></span>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">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>
<br></blockquote></div><span class=""><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</font></span></div></div>
</blockquote></div><br></div></div>