dita — archive
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
— [Date Index]
| [Thread Index]
| [Month Index]
| [List Home]
Why There are Constraints on Conref
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
[email protected]
http://dita.xml.org/blog/25
| From: | Andrzej Zydron <[email protected]> |
| To: | Su-Laine Yeo <[email protected]> |
| Cc: | ekimber <[email protected]>, JoAnn Hackos <[email protected]>, Michael Priestley/Toronto/IBM@IBMCA, [email protected], dita <[email protected]> |
| 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
> [email protected]
> www.justsystems.com
>
>
>
>
>
>
>
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
— [Date Index]
| [Thread Index]
| [Month Index]
| [List Home]