Hi Andrzej,
We do take notice, and review it, and
send you comments, which you incorporate. See the section on conreffing
proper nouns. Nothing that Su-Laine describes contradicts those practices,
which are allowable with a bunch of caveats, and I'm concerned that you
think it does.
Michael Priestley, Senior Technical
Staff Member (STSM)
Lead IBM DITA Architect
http://dita.xml.org/blog/25
From:
Andrzej Zydron <>
To:
Su-Laine Yeo <>
Cc:
ekimber <>,
JoAnn Hackos <>, Michael Priestley/Toronto/IBM@IBMCA,
, dita <>
Date:
09/26/2009 01:55 PM
Subject:
Re: [dita] Why There are Constraints
on Conref
Hi Su-Laine,
The DITA Translation Sub Committee, chaired by JoAnn, has produced
detailed guidelines and best practice documents on the use of conref,
and one of the first rules is to never use this mechanism for replacing
individual words. JoAnn will be able to cite real world examples of the
type of disaster that this can cause.
Does no one take any notice of the output of the Translation Sub
Committee? This is not the first time that I have come across this issue
recently.
Best Regards,
AZ
Su-Laine Yeo wrote:
> I'm having one of those, "this can't be right" moments.
Either I've
> completely misunderstood something or we have a problem.
>
> Consider this very common use of conref: You have a list of product
> names, with each product name in a <ph> element. Your <ph>
elements that
> contain product names are all stored in a <topic> element within
a
> product names file, which uses the ditabase DTD. With DITA 1.1 you
can
> conref those product names into any topic type.
>
> Say you have a task written in DITA 1.1 which includes a conref pointing
> to a product name in the product names file. What is going to happen
> when you upgrade your DTDs to DITA 1.2? If I understand the way
> constraints on conref are supposed to work, that conref is going to
be
> considered invalid even though <ph> has exactly the same content
model
> in <task> as it does in <topic>. Is that correct?
>
> Regards,
> Su-Laine
>
> Su-Laine Yeo
> Interaction Design Specialist
> JustSystems Canada, Inc.
> Office: 778-327-6356
>
> www.justsystems.com
>
>
>
>
>
>
>
