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: Quick reality check on FAQ item #2


There is one part of FAQ item #2 that I would like TC members to do a quick reality check on. (FAQ item #2 is the one about “Question about the order in which keys are resolved".)

 

Eliot wrote the FAQ item; I edited it heavily and added example #3.

 

I’m confident that the “Overview of key-binding precedence” and the examples make it clear how keys should be resolved. However, I’d like to make sure that a statement in the introduction to the FAQ maps well to the content explicated in the “Overview” and examples.

 

Here is a copy-and-paste of the introduction, with the key (no pun intended) text highlighted in bold:

----------------------------------------------------------------------------

A root map and its referenced sub maps can contain multiple different definitions for a key. So, given the possibility of multiple definitions for a key name, how does a processor determine which key name is effective?

The DITA 1.2 specification outlines the following rules:

  1. Determine the root map
  2. Construct the map tree

First, the processor must determine the root map that establishes the key space. (A processor cannot perform key resolution until the appropriate resolution context has been defined.) For processors such as the DITA Open Toolkit, the root map is obvious–it is the DITA map to which a transformation is applied–but for authoring tools and component content management systems, the root map is not necessarily obvious; such processors might require that a user explicitly select the root map.

Second, the processor must construct the map tree. The map tree consists all maps referenced from the root map by @href attributes, all maps referenced from submaps by @href attributes, and so on down the map hierarchy.

The order in which processors must construct the map tree is determined by the document order of the references to the maps in a normal depth-first traversal of the element tree in each map.

Note:

1.    The term document order is formally defined in the XPath Recommendation: http://www.w3.org/TR/xpath/#dt-document-order

2.    The term map tree refers to the tree of maps constructed as described here, not the XML element tree for the elements within a single map document.

 

----------------------------------------------------------------------------

 

Does the text highlighted in bold clearly and unambiguously match what is outlined the subsequent sections of the FAQ?

 

You can view the draft FAQ at http://wiki.oasis-open.org/dita/FAQ-items; the Wiki page for review comments is at http://wiki.oasis-open.org/dita/Review-FAQ-

Best regards,

Kris

Kristen James Eberlein l DITA Architect and Technical Specialist l SDL Structured Content Technologies Division l (t) + 1 (919) 682-2290 l keberlein@sdl.com

SDL.com

Please consider the environment before printing this e-mail

 



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