<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, May 28, 2014 at 11:59 AM, 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/28/2014 04:04 PM, Anne Gentle wrote:<br>
> Here's what I'll update in the Documentation/Conventions page if<br>
> everyone agrees:<br>
><br>
> For file names, use bk_ ch_ and sec_ at the beginning of the file name<br>
> to indicate the type of file it is in the hierarchy of the build. For<br>
> further organization, you can use subdirectories to organize the files<br>
> by a particular grouping such as project or topic.<br>
<br>
</div>Agreed (with using section as mentioned as followup)<br>
<div class=""><br>
> For xml:id creation, follow these guidelines.<br>
>  - xml:id must be unique across a built deliverable, otherwise you get<br>
> build errors<br>
>  - xml:id creates the HTML file name so it should be human-readable, not<br>
> codified like the file name<br>
>  - xml:id should closely follow the actual title in the text, using<br>
> dashes for spaces<br>
<br>
</div>I normally use underscores for spaces.<br></blockquote><div><br></div><div>Ah, okay. I was thinking of Drupal/Wordpress convention and wondering if one is preferred over the other for search optimization, anyone know?</div>

<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class=""><br>
>  - xml:id creation should consider search and find-ability as well as<br>
> human-readability<br>
><br>
> I prefer not to document the use a processing instruction like <?dbhtml<br>
> filename="name"> as that should be the rare exception.<br>
><br>
<br>
</div>Agreed, thanks,<br>
<div class="HOEnZb"><div class="h5"><br>
Andreas<br>
--<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>
</div></div></blockquote></div><br></div></div>