Open Stack

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.

On Mon, Oct 20, 2014 at 12:13 PM, Anne Gentle <anne at openstack.org> wrote:

> 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.
>
> Generally speaking, yes, we want to move towards a topic-oriented model,
> and the xi:include chunking lets us do that.
>
> Thanks,
> Anne
>
> On Mon, Oct 20, 2014 at 11:36 AM, Elke Vorheis <elkev at yahoo.com> wrote:
>
>> Hello Anne,
>>
>> 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.
>>
>> 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?
>>
>> Since I am a newbie to OpenStack, please let me know if this is the
>> appropriate method of communicating with you.
>>
>> Regards and thanks,
>>
>> Elke Vorheis
>> (650) 291-1375 (cell)
>> elkev at yahoo.com (email)
>>
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20141020/0f561050/attachment.html>