Support for learningDomain1 and learningDomain2

Darwin Information Typing Architecture (DITA) Version 1.3 Part 3: All-Inclusive Edition

version
1.3
author
OASIS DITA Technical Committee

Many questions require multiple block elements for the question statement ("prompt" or "stimulus" in instructional design parlance) and for feedback. The DITA 1.2 interaction design, learningDomain (and referred to informally as "learning 1"), only allows for a single paragraph question and single-paragraph feedback. The learningDomain2 design allows block elements with question statements, answer content, and feedback.

The DITA 1.3 learningDomain2 support deprecates the DITA 1.2 learningDomain1, but enables backward compatibility by redefining the learningAssessment topic with the option of using either the DITA 1.2 support or the DITA 1.3 support or both.

Note: The OASIS-provided document-type shells that integrate the learning domains integrate both the learning and learning2 domains. The learning and training modules include constraint modules that allow only the learning or only the learning2 domain; these constraint modules can be integrated into custom document-type shells.

learningDomain2

DITA 1.3 defines two new domains for the learning and training vocabulary: interactionBase2Domain and learning2Domain. These two new domains mirror the existing interactionBase and learning domains, but they provide a base model that allows multi-paragraph questions, answers, and feedback. The new domains are otherwise semantically identical to the original domains.

learningInteractionBase2Domain
lcInteractionBase2

The lcInteractionBase2 element differs from lcInteractionBase as follows:

  • Is a specialization of div rather than fig. It removes the content limitations that were imposed by fig, such as the inability to include table. The 1.3 specialization allows all content allowed in div.
  • Uses lcQuestionBase2 in place of lcQuestionBase to allow multiple paragraphs within its content.
  • Makes id attribute optional for all interactions.
lcQuestionBase2
The lcQuestionBase2 element is also a specialization of div and allows the same content as div. div allows all content that occurs in body except section and bodydiv.
lcInteractionLabel2
The lcInteractionLabel2 is a specialization of p and replaces the use of title. This element is necessary because div does not allow title.
learning2Domain
The learning2Domain is closely modeled on the 1.2 learningDomain. It defines new versions of each of the interaction types, each of which are specialized from lcInteractionBase2. The learning2Domain is not dependent on the original learningDomain. The learning2Domain can be used by itself or integrated along with the learningDomain.