← Prev in month ← Prev in thread

Issues noticed with taskbody content model in various task types

From
Robert D Anderson <>
Date
2016-07-01T19:49:32+00:00
ID
Thread
Issues noticed with taskbody content model in various task types
I noticed an oddity with taskbody when reviewing the generated content model tables.

Specifically, it does not allow the new <tasktroubleshooting> element, because the machinery taskbody constraint was not updated to account for it. I assume this was an oversight in 1.3 (probably related to the fact that the original owners of the Machinery Task are no longer participating at the TC).

This led to a few discoveries in the text:

There is a normative concept topic about the machinery task that specifically describes the contents - also missing the element. This means both our grammar files and our normative text do not allow for the element.
http://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/technicalContent/dita-machinerytask-topic.html
In the same topic, the element <prelreqs> does not use the new XML mention domain. This should be fixed in the errata. I am very happy to say this is the first instance I've seen where markup made it into the final spec without using that domain.

There is a similar concept describing general task, which mentions every section in the general task. It does not list tasktroubleshooting. In this case, the grammar files that allow the element are normative, so I think this is clearly an errata item - the concept should be updated to list the element.
http://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/technicalContent/dita-generic-task-topic.html
The same issue exists in the concept for strict task, which lays out the sections that can be used, in order. As with the general task, this looks like an errata item - the concept should be updated to list the element.
http://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/technicalContent/dita-task-topic.html

Regards,
Robert D. Anderson 
DITA-OT lead and Co-editor DITA 1.3 specification,
Digital Services Group 

E-mail: 
Digital Services Group 

11501 BURNET RD,, TX, 78758-3400, AUSTIN, USA
← Prev in month ← Prev in thread