<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"><meta http-equiv="Content-Type" content="text/html charset=windows-1252"><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">I’m coming in late to this conversation, because travel. In short, though, I think I’m in agreement with most of you. Let’s avoid conditionals if we can, the Install Guide is hard enough as it is. I also like the idea of combining the guides if it’s possible. There’s a certain amount of complexity around the user guides, and readers are generally bad at self-selecting their ‘audience type’, and so go looking for content in all the wrong places. As we move towards a more EPPO-style body of content, our books should naturally be getting somewhat larger, so overall size isn’t bothering me too much at this point. As for number of files, like Andreas said, let the form follow the function.<div><br></div><div>L<br><div><br></div><div><br><div><div>On 24 Oct 2015, at 3:02 am, Anne Gentle <<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div dir="ltr" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><div class="gmail_extra"><br class="Apple-interchange-newline"><br><div class="gmail_quote">On Fri, Oct 23, 2015 at 1:10 AM, Joseph Robinson<span class="Apple-converted-space"> </span><span dir="ltr"><<a href="mailto:joseph.robinson@rackspace.com" target="_blank">joseph.robinson@rackspace.com</a>></span><span class="Apple-converted-space"> </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;"><div style="word-wrap: break-word; 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.<span class="Apple-converted-space"> </span><b>A point for discussion<span class="Apple-converted-space"> </span></b>here to eventually improve or change the docs spec<b><span class="Apple-converted-space"> </span>– 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: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-color: rgb(204, 204, 204); border-left-style: solid; padding-left: 1ex;"><div style="word-wrap: break-word; font-size: 14px; font-family: Calibri, sans-serif;"><div><b></b></div><div><div><font><font face="Calibri">Best Regards,</font></font></div><div> </div><div>Joseph Robinson</div><div>Information Developer I</div><div> -------------------------------</div><div><a href="mailto:Joseph.Robinson@Rackspace.com">Joseph.Robinson@Rackspace.com</a></div><div><br></div><div><br></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<span class="Apple-converted-space"> </span><a href="http://www.rackspace.com.au/company/legal-privacy-statement.php" target="_blank">www.rackspace.com.au/company/legal-privacy-statement.php</a><span class="Apple-converted-space"> </span>- 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<span class="Apple-converted-space"> </span><a href="mailto:abuse@rackspace.com" target="_blank">abuse@rackspace.com</a><span class="Apple-converted-space"> </span>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>--<span class="Apple-converted-space"> </span><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><span style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;">_______________________________________________</span><br style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><span style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;">OpenStack-docs mailing list</span><br style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><a href="mailto:OpenStack-docs@lists.openstack.org" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">OpenStack-docs@lists.openstack.org</a><br style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></blockquote></div><br><div>
<div>Lana Brindley<div>Technical Writer</div><div>Rackspace Cloud Builders Australia</div></div><div><br></div><br class="Apple-interchange-newline">
</div>
<br></div></div></body></html>