<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Oct 23, 2015 at 1:10 AM, Joseph Robinson <span dir="ltr"><<a href="mailto:joseph.robinson@rackspace.com" target="_blank">joseph.robinson@rackspace.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">



<div style="word-wrap:break-word;color:rgb(0,0,0);font-size:14px;font-family:Calibri,sans-serif">
<div>Hello all,</div>
<div><br>
</div>
<div>For the M summit next week, I’ve put together a spec for reorganising the User Guides for the M release with the User Guides Team.</div>
<div><br>
</div>
<div><a href="https://review.openstack.org/#/c/238770/" target="_blank">https://review.openstack.org/#/c/238770/</a></div>
<div><br>
</div>
<div>On some of the Proposed Changes:</div>
<div><br>
</div>
<div>I raised number of files in the repository as a proposed change for visual reasons – file number has no effect on the build, but my thoughts are that smaller repos might make the guide easier to search and handle. This idea spun out of User Guide team
 talks during the conversion to .rst format.</div>
<div><br>
</div>
<div>Conditionals was an (slightly naïve) idea I had for combining the guides together.
<b>A point for discussion </b>here to eventually improve or change the docs spec<b> – Should the User Guides be reorganised to have conditionals?</b></div>
<div><b><br></b></div></div></blockquote><div><br></div><div>In a word, no.</div><div><br></div><div>Let's keep it simple rather than add complexity. The goal with the RST migration is simplification to enable more contributors as OpenStack grows. Users especially shouldn't have any further burden than they already do.</div><div><br></div><div>Thanks for asking -</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word;color:rgb(0,0,0);font-size:14px;font-family:Calibri,sans-serif"><div><b>
</b></div>
<div>
<div>
<div><font color="#000000"><font face="Calibri">Best Regards,</font></font></div>
<div> </div>
<div>Joseph Robinson</div>
<div>Information Developer I</div>
<div> -------------------------------</div>
<div>Joseph.Robinson@Rackspace.com</div>
<div><br>
</div>
<div><br>
</div>
</div>
</div>
   
<hr>
Rackspace Hosting Australia PTY LTD a company registered in the state of Victoria, Australia (company registered number ACN 153 275 524) whose registered office is at Level 1, 37 Pitt Street, Sydney, NSW 2000, Australia. Rackspace Hosting Australia PTY LTD
 privacy policy can be viewed at <a href="http://www.rackspace.com.au/company/legal-privacy-statement.php" target="_blank">www.rackspace.com.au/company/legal-privacy-statement.php</a> - This e-mail message may contain confidential or privileged information intended for the recipient. Any dissemination, distribution or copying of the enclosed material
 is prohibited. If you receive this transmission in error, please notify us immediately by e-mail at <a href="mailto:abuse@rackspace.com" target="_blank">abuse@rackspace.com</a> and delete the original message. Your cooperation is appreciated.
</div>

<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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</div></div>