OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


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 
> syeo@justsystems.com
> www.justsystems.com 
>
>
>
>
>
>
> -----Original Message-----
> From: ekimber [mailto:ekimber@reallysi.com] 
> Sent: Friday, September 25, 2009 3:53 PM
> To: JoAnn Hackos; Su-Laine Yeo; Michael Priestley; rob@ascan.ca
> Cc: dita; Ogden, Jeff
> Subject: Re: [dita] Why There are Constraints on Conref
>
> On 9/25/09 5:31 PM, "JoAnn Hackos" <joann.hackos@comtech-serv.com>
> wrote:
>
>   
>> Are we clear in saying that one cannot conref between Task and General
>> Task at all? or only from Task to General Task? Is it possible to
>>     
> conref
>   
>> from General Task to Task?
>>
>> From loose to more constrained, will the conref work?
>> So can I conref a prereq from General Task to a prereq to Task but not
>> vice versa? 
>>
>> But, I cannot conref a <step> from Task to General Task even though
>>     
> they
>   
>> are in both models?
>>
>> Would someone please state all the use cases simply? I'm trying to be
>> clear in writing the arch spec and the feature description and I'm
>>     
> still
>   
>> confused by all the rhetoric being flung around.
>>     
>
> Give a strict task and a general task:
>
> 1. Can conref elements from strict task into general task
> 2. Cannot conref elements from general task into strict task
>
> That is, you can *always* conref more-constrained elements into
> less-constrained elements. You can *never* conref less-constrained
> elements
> into more-constrained elements.
>
> Cheers,
>
> Eliot
> ----
> Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc.
> email:  ekimber@reallysi.com <mailto:ekimber@reallysi.com>
> office: 610.631.6770 | cell: 512.554.9368
> 2570 Boulevard of the Generals | Suite 213 | Audubon, PA 19403
> www.reallysi.com <http://www.reallysi.com>  | http://blog.reallysi.com
> <http://blog.reallysi.com> | www.rsuitecms.com
> <http://www.rsuitecms.com> 
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 
>
>   

-- 
email - azydron@xml-intl.com
smail - c/o Mr. A.Zydron
	PO Box 2167
        Gerrards Cross
        Bucks SL9 8XF
	United Kingdom
Mobile +(44) 7966 477 181
FAX    +(44) 1753 480 465
www - http://www.xml-intl.com

This message contains confidential information and is intended only for
the individual named.  If you are not the named addressee you may not
disseminate, distribute or copy this e-mail.  Please notify the sender
immediately by e-mail if you have received this e-mail by mistake and
delete this e-mail from your system.
E-mail transmission cannot be guaranteed to be secure or error-free as
information could be intercepted, corrupted, lost, destroyed, arrive
late or incomplete, or contain viruses.  The sender therefore does not
accept liability for any errors or omissions in the contents of this
message which arise as a result of e-mail transmission.  If verification
is required please request a hard-copy version. Unless explicitly stated
otherwise this message is provided for informational purposes only and
should not be construed as a solicitation or offer.


begin:vcard
fn;quoted-printable:Andrzej Zydro=C5=84
n;quoted-printable:Zydro=C5=84;Andrzej
email;internet:azydron@xml-intl.com
tel;work:+441494558106
tel;home:+441494532343
tel;cell:+447966477181
x-mozilla-html:FALSE
version:2.1
end:vcard



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]