<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif; ">
<div>
<div>
<div>+1 subdirectories</div>
<div>
<div>
<div style="color: rgb(0, 0, 0); "><font class="Apple-style-span" color="rgb(0, 0, 0)" face="Apple Chancery"><i>Diane</i></font></div>
<div style="font-family: Calibri, sans-serif; font-size: 14px; color: rgb(0, 0, 0); ">
<font class="Apple-style-span" color="rgb(0, 0, 0)"><i>----------------------------------------------</i></font></div>
<div style="font-family: Calibri, sans-serif; font-size: 14px; color: rgb(0, 0, 0); ">
<font class="Apple-style-span" color="rgb(0, 0, 0)">Diane Fleming</font></div>
<div style="font-family: Calibri, sans-serif; font-size: 14px; ">
<div style="color: rgb(0, 0, 0); ">Software Developer II - US</div>
</div>
diane.fleming@rackspace.com</div>
<div>Cell 512.323.6799</div>
<div>Office 512.874.1260<br>
<span class="Apple-style-span" style="font-family: Calibri, sans-serif; ">
<div style="font-family: Calibri, sans-serif; font-size: 14px; ">
<div style="color: rgb(0, 0, 0); ">Skype drfleming0227</div>
<div style="color: rgb(0, 0, 0); ">Google-plus diane.fleming@gmail.com</div>
</div>
</span></div>
</div>
</div>
</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Lucida Grande; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>Matt Kassawara <<a href="mailto:mkassawara@gmail.com">mkassawara@gmail.com</a>><br>
<span style="font-weight:bold">Date: </span>Monday, May 26, 2014 10:53 AM<br>
<span style="font-weight:bold">To: </span>Nick Chase <<a href="mailto:nchase@mirantis.com">nchase@mirantis.com</a>><br>
<span style="font-weight:bold">Cc: </span>Andreas Jaeger <<a href="mailto:aj@suse.com">aj@suse.com</a>>, "<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>><br>
<span style="font-weight:bold">Subject: </span>Re: [Openstack-docs] Conventions for filenames and chapter/section IDs<br>
</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr">I like the idea of subdirectories. During the installation guide updates project, I broke the neutron content into smaller files to simplify editing and to reduce chances of patch collisions. However, this increased the overall number of files.
Implementing subdirectories would mitigate this issue. The installation guide swift chapter already uses a subdirectory which I'm debating suggesting for the remainder of the installation guide and potentially other books.</div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Mon, May 26, 2014 at 9:32 AM, Nick Chase <span dir="ltr">
<<a href="mailto:nchase@mirantis.com" target="_blank">nchase@mirantis.com</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">OK, so as I'm breaking out the HA chapter at this very minute, let me throw something else into the mix. The HA Guide is broken into 2 parts, each with a number of chapters, each with a number of sections. Right now I've broken it down into
chapter files, but as I get down to the section level I begin to get overwhelmed with the number of files. Is there any objection to grouping section files in folders by chapter? For example:
<div><font color="#000000"><br>
</font></div>
<div><font color="#000000">ch_aa_network.xml</font></div>
<div><font color="#000000">ch_aa_network/sec_r<span style="font-family:monospace;font-size:13px">un_neutron_dhcp_agent.xml</span></font></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000"><br>
</font></span></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000">I mean, I can just as easily make it</font></span></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000"><br>
</font></span></div>
<div>
<div><font color="#000000">ch_aa_network.xml</font></div>
<div><font color="#000000">sec_r<span style="font-family:monospace;font-size:13px">un_neutron_dhcp_agent.xml</span></font></div>
</div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000"><br>
</font></span></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000">But it starts to get really messy.</font></span></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000"><br>
</font></span></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000">Thoughts?</font></span></div>
<span class="HOEnZb"><font color="#888888">
<div><span style="font-family:monospace;font-size:13px"><font color="#000000"><br>
</font></span></div>
<div><span style="font-family:monospace;font-size:13px"><font color="#000000">---- Nick</font></span></div>
<div><br>
</div>
</font></span></div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">
<div class="">On Sun, May 25, 2014 at 5:50 PM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br>
</div>
<div>
<div class="h5">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div>----- Original Message -----<br>
> From: "Anne Gentle" <<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>><br>
> To: "Andreas Jaeger" <<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>><br>
><br>
> Something to think about for ch and sec is that we won't always author in a<br>
> book-like manner, so let's not lock ourselves into that sort of thinking<br>
> due to current file names.<br>
><br>
> Stick to the install guide for now, to apply conventions, just please don't<br>
> use something as meaningful semantically as chapter and section.<br>
<br>
</div>
I actually think it's important/useful information in the filename. It reflects the root node of the file's XML which has an impact on where you can nest/include it in another document (you can't include a chapter in a section for example, but you can include
a section in a chapter). It's got more to do with the realities of the format being used than whether we're thinking in terms of books, articles, etc.<br>
<br>
Granted if we moved to a non-XML format this would no longer be the case, but I think we'd have bigger conversion issues than bulk renaming the files/links. ;)<br>
<span><font color="#888888"><br>
-Steve<br>
</font></span>
<div>
<div><br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">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>
</div>
</div>
</blockquote>
</div>
</div>
</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>
</div>
</div>
</span>
</body>
</html>