<html><body><div style="color:#000; background-color:#fff; font-family:verdana, helvetica, sans-serif;font-size:10px"><div><span>Hello Anne,</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span><br></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>Thanks for the quick response. I agree with you that xinclude statements are probably the best way to approximate topic-based writing and provide one avenue to leverage the re-use of content/files. Therefore I will take your advice and plan to continue the restructuring of the Networking Guide based on the use of xinclude statements.</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color:
 transparent;"><span><br></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>If you have any other sage advice, can you please share. I am new to OpenStack and would appreciate any helpful hints.</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span><br></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>Thanks again, Elke</span></div><div></div><div> </div><div>Elke Vorheis<br>(650) 291-1375 (cell)<br>elkev@yahoo.com (email)</div> <div class="qtdSeparateBR"><br><br></div><div class="yahoo_quoted" style="display: block;"> <div style="font-family: verdana, helvetica, sans-serif; font-size: 10px;"> <div
 style="font-family: HelveticaNeue, 'Helvetica Neue', Helvetica, Arial, 'Lucida Grande', sans-serif; font-size: 16px;"> <div dir="ltr"> <font size="2" face="Arial"> On Monday, October 20, 2014 10:13 AM, Anne Gentle <anne@openstack.org> wrote:<br> </font> </div>  <br><br> <div class="y_msg_container"><div id="yiv4117744764"><div><div dir="ltr">Thanks for asking on the list Elke. It's not really my decision, but we do like to work in similar ways, and it helps the core reviewers (there are about a dozen of us active) know how to review your patches. So the mailing list is best, thanks.<div><br clear="none"></div><div>Generally speaking, yes, we want to move towards a topic-oriented model, and the xi:include chunking lets us do that. </div><div><br clear="none"></div><div>Thanks,</div><div>Anne</div></div><div class="yiv4117744764yqt4335531366" id="yiv4117744764yqt12741"><div class="yiv4117744764gmail_extra"><br clear="none"><div
 class="yiv4117744764gmail_quote">On Mon, Oct 20, 2014 at 11:36 AM, Elke Vorheis <span dir="ltr"><<a rel="nofollow" shape="rect" ymailto="mailto:elkev@yahoo.com" target="_blank" href="mailto:elkev@yahoo.com">elkev@yahoo.com</a>></span> wrote:<br clear="none"><blockquote class="yiv4117744764gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><div><div style="color: rgb(0, 0, 0); font-family: verdana, helvetica, sans-serif; font-size: 10px; background-color: rgb(255, 255, 255);"><div><span>Hello Anne,</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span><br clear="none"></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>I am the new writer for the Networking Guide. Last week I finally started to
 work on the Networking Guide. It looks like the "chunks" of content that essentially make up the equivalent of a topic (and subtopics) are all separated via xinclude statements instead of being directly included in the chapter file as a section. I therefore assumed that this method was supposed to be followed with respect to all future modifications, deletions, and additions for this document.</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span><br clear="none"></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>However, when I raised this issue with the small group of folks I work with, they indicated that i should get in touch with you to see if this structure of having xinclude statements that basically represent topics is the
 chosen method that I should follow in the future for this document?</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span><br clear="none"></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>Since I am a newbie to
 OpenStack, please let me know if this is the appropriate method of communicating with you.</span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span><br clear="none"></span></div><div style="color: rgb(0, 0, 0); font-size: 10px; font-family: verdana, helvetica, sans-serif; font-style: normal; background-color: transparent;"><span>Regards and thanks,</span></div><div></div><div> </div><div>Elke Vorheis<br clear="none"><a rel="nofollow" shape="rect" href="">(650) 291-1375</a> (cell)<br clear="none"><a rel="nofollow" shape="rect" ymailto="mailto:elkev@yahoo.com" target="_blank" href="mailto:elkev@yahoo.com">elkev@yahoo.com</a> (email)</div></div></div></blockquote></div><br clear="none"></div></div></div></div><br><br></div>  </div> </div>  </div> </div></body></html>