<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body dir="auto">
<div>+1 for file name conventions</div>
<div>-1 for xml:id conventions</div>
<div><br>
</div>
<div><br>
<br>
Sent from my iPhone</div>
<div><br>
On May 25, 2014, at 6:28 PM, "Anne Gentle" <<a href="mailto:anne@openstack.org">anne@openstack.org</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div>
<div dir="ltr"><br>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Sun, May 25, 2014 at 4:50 PM, Steve Gordon <span dir="ltr">
<<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="">----- Original Message -----<br>
> From: "Anne Gentle" <<a href="mailto:anne@openstack.org">anne@openstack.org</a>><br>
> To: "Andreas Jaeger" <<a href="mailto:aj@suse.com">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>
</blockquote>
<div><br>
</div>
<div>I agree it's a useful codification in the file name, but I don't think we want it in the xml:id. The xml:id is used for SEO, for human-readable URLs, and so on. Let's not leak our abstraction further than we have to. :)</div>
<div>Anne</div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<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 class="HOEnZb"><font color="#888888"><br>
-Steve<br>
</font></span></blockquote>
</div>
<br>
</div>
</div>
</div>
</blockquote>
<blockquote type="cite">
<div><span>_______________________________________________</span><br>
<span>Openstack-docs mailing list</span><br>
<span><a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a></span><br>
<span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></span><br>
</div>
</blockquote>
</body>
</html>