Migrating from DITA 1.2 to 1.3

DITA 1.3 defines two new domains for describing learning and training interactions: learningInteractionBase2Domain and learning2Domain. These two new domains mirror the DITA 1.2 learningInteractionBase and general learning domains, but the new versions provide support for multi-paragraph questions, answers, and feedback. The new domains are otherwise semantically identical to the original domains.

For backwards compatibility, both interactions domains are supported in DITA 1.3, and the document type shells provided with DITA 1.3 include both. In order to use the new elements, existing non-OASIS document type shells need to be updated to reference the new domain. See the OASIS provided DTD, RNG, or XSD shells for learningContent for examples of how to integrate these domains, or follow your normal process for integrating a new domain.

To migrate to the Learning 2 Domain, element tags in existing learning documents need to be transformed to the new names. This is done by adding a 2 to each element name in DITA documents that use the old domain. Once the element names have been changed, it is safe to remove the old domain from your shells. The complete list of elements to migrate is as follows: