A root map is any DITA map—including specialized DITA maps—that serves as the entry point to a network of linked resources such that every resource in that network can be reached by using this DITA map as a starting point for traversing the network. Resources include DITA topics, other DITA maps, and non-DITA targets. Network traversal occurs anywhere within the network by following any type of link, direct or indirect, that is defined in the DITA specification.
Hey, Jim.
We added a definition of "root map" to the spec for DITA 1.3. We had HUGE difficulty agreeing upon a definition -- Can we get a volunteer to search the minutes and DITAweb review log? -- and what we have is what all would agree to. Yes, it is terse and minimalistic.
Putting on my spec editor hat, I'd want to see a list of all the places that the term is referenced in the DITA 1.3 spec before considering a change.
Of course, improving spec terminology and introducing a glossary really should be a VERY high priority item for DITA 2.0.
I'm not really comfortable with your suggested change, however.
I'm reluctant to suggest an alternative without seeing all the places the term is used in the spec, but maybe the following would work:
"The DITA map that is provided as input for a processor, which provides the context for all referenced items" ...
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)
On 4/6/2018 1:25 PM, Jim Tivy wrote:
Hi Folks
The term root map is used throughout the 1.3 DITA Spec.
However, its definition near the end of section 2.1.1 is bit terse given the number of times it is used in other places in the spec and given its importance to DITA processing.
Current definition says:
root map:
The DITA map that is provided as input for a processor.
Perhaps we could have something like this :)
root map:
The topmost DITA map in a map hierarchy used as input to a processor. This map hierarchy is often traversed by processors to enumerate topics and to, in turn, determine the context for each topic. In this sense, a root map establishes the context of a topic.
cheers
Jim
------------------------------------------------------------ ---------
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_work groups.php
------------------------------------------------------------ --------- 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/app s/org/workgroup/portal/my_work groups.php