Re: [dita-comment] Does the specs allow making conrefs from topics to maps?

[Kristen James Eberlein <kris@eberleinconsulting.com>]

Radu -- It is perfectly appropriate to conref from a task to topic. Or a title from a map into a topic (or vice versa).

The statement that you quoted from the 1.2 spec -- "When pulling content with the conref mechanism – if the referenced element is the same type as the referencing element, and the list of domains declared on the domains attribute in the referenced topic or map instance is the same as or a subset of the list of domains declared in the referencing document, the element set allowed in the referenced element is guaranteed to be the same as, or a subset of, the element set allowed in the referencing element." -- was not intended to be the whole story.

That is, the content of the sentence is perfectly true -- but it should NOT be read to mean that the domains on the referenced element must be the same or a subset of the domains on the referencing element. If they are the same, super; if not, processors SHOULD generalize.

The sentence that followed this content in the 1.2 spec was " A processor resolving a conref should tolerate specializations of valid elements and should generalize elements in the pulled content fragment as needed for the referencing context."

I'll talk with Robert Anderson about whether we need to modify the 1.3 draft spec to make this clearer.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

On 1/28/2015 4:23 AM, Radu Coravu wrote:

Hi guys,

Any updates on this one?

According to the same domains limitation the specs imposes when making a conref, it would also seem that you cannot conref from a topic content which is located in a task because the task domains are a superset of the topic domains.

Regards,
Radu

Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

On 1/22/2015 8:38 AM, Radu Coravu wrote:

Dear DITA TC,

This all started here:

http://www.oxygenxml.com/forum/post32583.html

The question would be if from a DITA topic I can make a conref to an
element defined in a DITA Map, the particular example discussed in the
forum thread is about reusing indexterms.

The DITA 1.2 specs states:

http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/conref.html

    When pulling content with the conref mechanism – if the referenced
element is the same type as the referencing element, and the list of
domains declared
on the domains attribute in the referenced topic or map instance is
the same as or a subset of the list of domains declared in the
referencing document,
the element set allowed in the referenced element is guaranteed to be
the same as, or a subset of, the element set allowed in the
referencing element.

I checked and the @domains attribute of the DITA Map seems to be a
superset of the DITA topic @domains attribute. From what the specs says,
in order for a conref from a topic to a map to be considered valid, the
map domains should be a subset of the topic domains in order for a
conref from a topic to a map to be considered properly valid.

So what's your opinion on this?

Regards,
Radu

Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com