OASIS Darwin Information Typing Architecture (DITA) TC

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/ )

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/ )