<div dir="ltr">We originally thought the networking guide would merely aggregate content from other documentation using includes, but further investigation into the latter (particularly the admin guide) revealed plenty of issues such as defunct information, disorganization, inconsistency, and just plain lack of comprehensive content. Now we plan to build and/or update content in the networking guide and use includes from other documentation to it.</div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 20, 2014 at 12:13 PM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><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></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></div><div>Thanks,</div><div>Anne</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 20, 2014 at 11:36 AM, Elke Vorheis <span dir="ltr"><<a href="mailto:elkev@yahoo.com" target="_blank">elkev@yahoo.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><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>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></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></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></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><a href="tel:%28650%29%20291-1375" value="+16502911375" target="_blank">(650) 291-1375</a> (cell)<br><a href="mailto:elkev@yahoo.com" target="_blank">elkev@yahoo.com</a> (email)</div></div></div></blockquote></div><br></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" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br></div>