For what it's worth, the DITA Style Guide recommends using names that
match the titles.
It also recommends using the extensions .dita and .ditamap, instead of
.xml. That way, you have more control over which tool opens the file,
and you can distinguish the files from other xml files used in DITA.
On 2011-11-03 15:02, Roger Shuttleworth wrote:
Hi Jim
You make a good point about updating xrefs and related-links, as well
as ditamaps, when a file name changes.
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.
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.
Thanks for your tip about GUIDs too. I will look more into that.
Roger Shuttleworth
Technical Documentation
AV-BASE Systems Inc.
1000 Air Ontario Drive, Suite 200
London, Ontario
N5V 3S4
Tel. 519 691-0919 ext. 330
------------------------------------------------------------------------
_______________________________________________
You are currently subscribed to framers as [email protected].
Send list messages to [email protected].
To unsubscribe send a blank email to
[email protected]
or visit
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com
Send administrative questions to [email protected]. Visit
http://www.frameusers.com/ for more resources and info.
