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:

DITA 1.2 element name DITA 1.3 element name
lcAnswerContent lcAnswerContent2
lcAnswerOption lcAnswerOption2
lcAnswerOptionGroup lcAnswerOptionGroup2
lcArea lcArea2
lcAreaCoords lcAreaCoords2
lcAreaShape lcAreaShape2
lcAsset lcAsset2
lcCorrectResponse lcCorrectResponse2
lcFeedback lcFeedback2
lcFeedbackCorrect lcFeedbackCorrect2
lcFeedbackIncorrect lcFeedbackIncorrect2
lcHotspot lcHotspot2
lcHotspotMap lcHotspotMap2
lcInstructornote lcInstructornote2
lcInteractionBase lcInteractionBase2
lcInteractionLabel lcInteractionLabel2
lcItem lcItem2
lcMatching lcMatching2
lcMatchingHeader lcMatchingHeader2
lcMatchingItem lcMatchingItem2
lcMatchingItemFeedback lcMatchingItemFeedback2
lcMatchingPair lcMatchingPair2
lcMatchTable lcMatchTable2
lcMultipleSelect lcMultipleSelect2
lcOpenAnswer lcOpenAnswer2
lcOpenQuestion lcOpenQuestion2
lcQuestion lcQuestion2
lcQuestionBase lcQuestionBase2
lcSequence lcSequence2
lcSequenceOption lcSequenceOption2
lcSequenceOptionGroup lcSequenceOptionGroup2
lcSequencing lcSequencing2
lcSingleSelect lcSingleSelect2
lcTrueFalse lcTrueFalse2