• MI Task implementation questions

Questions about implementation and spec information for Machine Industry Task

Open Questions

Resolved Questions

• Where is the definition of the new note values (caution1, caution2, notice, warning)?
  • The ANSI definition for the 6 safety levels are:
    • danger: DANGER indicates an imminently hazardous situation which, if not avoided, will result in death or serious injury.
    • warning: WARNING indicates a potentially hazardous situation which, if not avoided, could result in death or serious injury.
    • caution level 1: CAUTION indicates a potentially hazardous situation which, if not avoided, may result in minor or moderate injury.
    • caution level 2: CAUTION used without the Safety Alert Symbol indicates a potentially hazardous situation which, if not avoided, may result in property damage.
    • notice: NOTICE used without the safety alert symbol indicates a potential situation which, if not avoided, may result in an undesierable result or state.
• I am still unclear on the difference between prelreqs and prereq - is prelreqs just a new name for the same element? Will also need a full definition for the language specification.

prereq has the open unchanged content model of section, prelreqs has a more restrictive content model derived from the S1000D standard. We are going to provide a full definition for the language specification.

• I am still unclear on the difference between closereqs and postreq - is closereqs just a new name for the same element? Will also need a full definition for the language specification.

postreq has the open unchanged content model of section, closereqs has a more restrictive content model derived from the S1000D standard. We are going to provide a full definition for the language specification.

• Why is closereqs specialized from example? Is it really an example?

To have it grouped at the end of the content model, right next to example. Actually it is a section type but as example has the same content model like section we have selected this as base element.

• What DTDs and Schemas should be part of the DITA 1.2 distribution? Is this correct: 1) Hazard Statement Domain, 2) MITask Domain that defines prelreqs and closereqs, 3) MITask Document Type that defines a task with these two domains.
  • CK: DITA Topics: topic, reference, concept, task, glossary
  • CK: DITA Domains: utility, highlighting, indexing, hazard statement, software, ui, programming. Plus machinerytask in task.
• Does the subcommittee want to have a "prelreqs" element instead of "prereq"? Is there a description of the difference between the two?
• Does the subcommittee want to have a "closereqs" element instead of "postreq"? Is there a description of the difference between the two?
• Do you want to remove the prereq and closereq elements?

"prelreq" is a specialization of section, "closereqs" is a specialization of "example" and should be added to the task. prereq and postreq should be replaced

the content model of taskbody will theoretically change from:

   (prereq | context | section)*, (steps | steps-unordered | process)?, result?, example*, postreq?

to

   (context | section | prelreqs)*, (steps | steps-unordered | process)?, result?, example*, closereqs?

A description of prelreqs and closereqs should be added in the DITA 1.2 documentation.

• Do you want to enforce an order for the task sections?

no order required, see example above

1) to be precise, the specialization of section and example in mitask.ent will look as follows:

<!ENTITY % mitask-d-section "prelreqs" >

<!ENTITY % mitask-d-example "closereqs" >