Open Stack

Hello Anne,

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.

If you have any other sage advice, can you please share. I am new to OpenStack and would appreciate any helpful hints.

Thanks again, Elke
 
Elke Vorheis
(650) 291-1375 (cell)
elkev at yahoo.com (email)


On Monday, October 20, 2014 10:13 AM, 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)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20141020/f2c918e0/attachment-0001.html>