<!DOCTYPE html PUBLIC '-//W3C//DTD HTML 4.01 Transitional//EN'>
<html><head><meta http-equiv="Content-Type" content="text/html;charset=us-ascii">
<style>BODY{font:10pt Tahoma, Verdana, sans-serif}</style></head><body>
Hi Jim<br><br>You make a good point about updating xrefs and related-links, as well as ditamaps, when a file name changes.<br><br>I have made good use of the map checking function in oXygen Author. You open the map in Author, then run it through an automated checking routine that will point out any problems such as missing files or inappropriate href values.<br><br>I sent a follow-up message to the original poster correcting my recommendation to use folders named according to deliverables. I meant to recommend using the product name, not the deliverable. Different deliverables are created from a single pool of files, using different maps; or perhaps using the same map filtered by ditaval.<br><br>Thanks for your tip about GUIDs too. I will look more into that.<br><br>Roger Shuttleworth<br>Technical Documentation<br>AV-BASE Systems Inc.<br>1000 Air Ontario Drive, Suite 200<br>London, Ontario<br>N5V 3S4<br>Tel. 519 691-0919 ext. 330<br><blockquote style="padding-left: 5px; margin-left: 5px; border-left: #0000ff 2px solid; margin-right: 0px"><hr><b>From:</b> Jim Owens [mailto:jowens@magma.ca]<br><b>To:</b> Roger Shuttleworth [mailto:rshuttleworth@avbasesystems.com]<br><b>Cc:</b> framers@lists.frameusers.com<br><b>Sent:</b> Thu, 03 Nov 2011 14:04:54 -0400<br><b>Subject:</b> Re: DITA file naming conventions<br><br> > As far as possible, make sure the file name matches the title of <br>
the topic. So if your topic is "Inserting the Widget" then your file <br>
name would be "inserting_the_widget.xml". I realize this may cause <br>
problems later if the title changes, but that doesn't happen often and <br>
you can usually make the change to the file name without too much hassle <br>
(changing it in ditamaps, etc.).<br>
><br>
<br>
Since this has come up, I was wondering if any DITA-aware CMS offerings <br>
can present the topic title or map title for selection by the user, <br>
instead of the file name. This would support the use of GUIDs for the <br>
file names, which would guarantee uniqueness, and allow users to adjust <br>
titles without having to manage ditamaps, related-links, or xrefs.<br>
<br>
_______________________________________________<br>
<br>
<br>
You are currently subscribed to framers as <a href="mailto:rshuttleworth@avbasesystems.com">rshuttleworth@avbasesystems.com</a>.<br>
<br>
Send list messages to <a href="mailto:framers@lists.frameusers.com">framers@lists.frameusers.com</a>.<br>
<br>
To unsubscribe send a blank email to<br>
<a href="mailto:framers-unsubscribe@lists.frameusers.com">framers-unsubscribe@lists.frameusers.com</a><br>
or visit <a href="http://lists.frameusers.com/mailman/options/framers/rshuttleworth%40avbasesystems.com" target="_blank">http://lists.frameusers.com/mailman/options/framers/rshuttleworth%40avbasesystems.com</a><br>
<br>
Send administrative questions to <a href="mailto:listadmin@frameusers.com">listadmin@frameusers.com</a>. Visit<br>
<a href="http://www.frameusers.com/" target="_blank">http://www.frameusers.com/</a> for more resources and info.<br>
</blockquote><style>
</style>
</body></html>