Added to 1.3 Errata page:
https://wiki.oasis-open.org/dita/DITA%201.3%20Errata
mag
From: dita@lists.oasis-open.org [mailto:dita@lists.oasis-open.org] On Behalf Of Robert D Anderson
Sent: Wednesday, March 02, 2016 2:49 PM
To: DITA TC
Subject: [dita] Issue with content model topics
As Tom might put it, the next ding in new car door... but fortunately found in non-normative topics.
Eliot noticed that the generated content model in the appendix is off for the <change-item> element:
http://docs.oasis-open.org/dita/dita/v1.3/os/part3-all-inclusive/contentmodels/cmltc.html#cmltc__change-item
It ends with a confusing model of
<data>, <sort-as> <sort-as>*
The <sort-as> element is a domain specialization of <data>, so the model should end with
(<data> | <sort-as)*
I've also noticed a few other elements that are off. From what I can tell with a lot of spot-checking, the problem seems to occur mostly where domain elements show up as part of a strict or specialized content model. That is -- I see issues when content models have a required order (such as a, then b, then c), and one of those elements is extended with a domain. It appears the most common error is an element or element group appearing more than once in the model.
In most of the cases I've found, the biggest issue is with elements or element groups appearing more than once, as <sort-as> does in the model for change-item. Another unfortunate example in that same topic is the chapter element, which includes a lot of domain extensions:
http://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/contentmodels/cmtcc.html#cmtcc__chapter
As I said, these are all non-normative, but we should still add this issue to the errata and ideally update the generation tools to get new versions of the topics.
Thanks -
Robert D Anderson
IBM Authoring Tools Development
Chief Architect, DITA Open Toolkit (http://www.dita-ot.org/)