<div dir="ltr">Something to think about for ch and sec is that we won't always author in a book-like manner, so let's not lock ourselves into that sort of thinking due to current file names.<div><br></div><div>Stick to the install guide for now, to apply conventions, just please don't use something as meaningful semantically as chapter and section.</div>

<div><br></div><div>Anne</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, May 25, 2014 at 2:50 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.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="">On 05/24/2014 04:45 PM, Matt Kassawara wrote:<br>
> Would consistently indicating type within an ID help clarify references?<br>
> For example, chapter IDs always start with "ch_", section IDs always<br>
> start with "sec_", figure IDs start with "fig_", etc.<br>
<br>
<br>
</div>Yeah, that would help.<br>
<br>
When I add xml:ids, I normally use sec_FILENAME for the first section<br>
and sec_FILENAME_TITLE for any additional sections. FILENAME is either<br>
the filename or the first title.<br>
<br>
I don't think we should remain now everything - but we should have a<br>
rule for new files and new xml:ids moving forward. Remaining has the<br>
problem that it creates new URLs and the old ones stay. Once that issue<br>
is fixed, we can rename more easily,<br>
<br>
Andreas<br>
<span class="HOEnZb"><font color="#888888">--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
</font></span><div class="HOEnZb"><div class="h5"><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>
</div></div></blockquote></div><br></div>