diff --git a/en-us/Learning_and_training_specialization.ditamap b/en-us/Learning_and_training_specialization.ditamap
index 89be1351..4577cfdd 100644
--- a/en-us/Learning_and_training_specialization.ditamap
+++ b/en-us/Learning_and_training_specialization.ditamap
@@ -9,7 +9,6 @@
Feeding Ducks How to feed a small- to medium -sized flock of domestic ducks. This course is intended for owners of small- to medium-sized flocks of domestic ducks. Topics covered include: The L&T specialization enables you to create learning materials, including
content and assessments. You might prefer a formalized approach, creating your content after careful
- planning and analysis. The L&T specialization includes a planning topic type
- that allows you to identify goals, needs, and objectives. The <learningGroup> and
+ You might prefer a formal approach, creating your content after careful planning and
+ analysis. The L&T specialization includes a planning topic type that allows you
+ to identify goals, needs, and objectives. The <learningGroup> and
<learningObject> elements allow you to use planning topic types at many levels of
your development. The L&T specialization provides many elements for instructional content. It does
not enforce a particular instructional design approach; you can pick and choose the
- elements that you want and adapt the model to your requirements. Transforming the
- content into materials, exams, or e-learning content is entirely up to you. While
- you can use the DITA Open Toolkit to generate a PDF, RTF, and other standard
- formats, there is no default course output type.
+
+
+
Transforming the content into materials, exams, or e-learning content is entirely up + to you. While you can use the DITA Open Toolkit to generate a PDF, RTF, and other + standard formats, there is no default course output type.
diff --git a/en-us/Learning_and_training_specialization/topics/lc_assessment_and_interactions.dita b/en-us/Learning_and_training_specialization/topics/lc_assessment_and_interactions.dita index 491731df..ad15f1ad 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_assessment_and_interactions.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_assessment_and_interactions.dita @@ -23,13 +23,13 @@ place students or post-tests to verify students' retention of material.This topic type is particularly helpful since it allows you to create content for student versions and answer keys simultaneously.
The main section of the topic goes within the <learningAssessmentbody> element. - Within that, questions are contained in the <lcInteracion> element, but the body + Within that, questions are contained in the <lcInteraction> element, but the body can also include other optional elements:
There are various types of questions that all interact differently. These +
The L&T provides a variety of of assessment questions, including mulitple choice, true/false, matching, and more. These interactions are defined in the learningDomain2, which is explained in detail in the next topic.
diff --git a/en-us/Learning_and_training_specialization/topics/lc_interaction_types.dita b/en-us/Learning_and_training_specialization/topics/lc_interaction_types.dita index 0d6241f7..86a841a2 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_interaction_types.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_interaction_types.dita @@ -17,17 +17,19 @@Interactions in the learningDomain2 can include the following parts:
Interactions in the learningDomain2 can include the following parts:
+Notice the use of 2 as in learningDomain2, lcTrueFalse2, and so on. An earlier version of L&T used <learningDomain>. The <learningDomain2> elements are more flexible and allow block elements like <p> within question elements.
The bulk of the interaction will be the question content. Different types of - questions have different elements:
Below is an example of a single select question.
-<learningAssessment id="la_l1_t1_ingredient_quality"> ++<learningAssessment id="la_l1_t1_ingredient_quality"> <title>Ingredient quality</title> - <shortdesc>Note that with an “all of the above” type answer, use the lcSingleSelect2 interaction type, rather than lcMultipleSelect2. If you use the lcMultipleSelect2 and a student selects all - correct answers (with or without the “all of the above” selection), most learning management systems (LMS) will mark this as an incorrect response. </shortdesc> <learningAssessmentbody> <lcInteraction id="lcInteraction_sqq_xws_rcb"> <lcSingleSelect2> - <lcQuestion2>Do not use grains that are contaminated with:</lcQuestion2> + <lcQuestion2>Do not use grains that are contaminated + with:</lcQuestion2> <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_skb_bxs_rcb"> <lcAnswerOption2> <lcAnswerContent2>Molds</lcAnswerContent2> - <lcFeedback2>Not just molds, but weed seeds and dirt too.</lcFeedback2> + <lcFeedback2>Not just molds, but weed seeds and dirt + too.</lcFeedback2> </lcAnswerOption2> <lcAnswerOption2> <lcAnswerContent2>Weed seeds</lcAnswerContent2> - <lcFeedback2>Not just weed seeds, but molds and dirt too.</lcFeedback2> + <lcFeedback2>Not just weed seeds, but molds and dirt + too.</lcFeedback2> </lcAnswerOption2> <lcAnswerOption2> <lcAnswerContent2>Dirt</lcAnswerContent2> - <lcFeedback2>Not just dirt, but molds and weed seeds too.</lcFeedback2> + <lcFeedback2>Not just dirt, but molds and weed seeds + too.</lcFeedback2> </lcAnswerOption2> <lcAnswerOption2> <lcAnswerContent2>All of the above</lcAnswerContent2> @@ -74,6 +79,8 @@ </learningAssessmentbody> </learningAssessment>+Note that with an “all of the above” type answer, use the lcSingleSelect2 interaction type, rather than lcMultipleSelect2. If you use the lcMultipleSelect2 and a student selects all + correct answers (with or without the “all of the above” selection), most learning management systems (LMS) will mark this as an incorrect response.
You should see this:
-<?xml version="1.0" encoding="utf-8"?> - <!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" "learningAssessment.dtd"> - <learningAssessment id="lca_practice"> - <title>Feed Quality Source</title> - <learningAssessmentbody> </learningAssessmentbody> - </learningAssessment>+
+<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" + "learningAssessment.dtd"> + <learningAssessment id="lca_practice"> + <title>Feed Quality Source</title> + <learningAssessmentbody> </learningAssessmentbody> + </learningAssessment>
Notice that the !DOCTYPE declaration calls out the learningAssessment
@@ -107,21 +116,25 @@
The <learningContent> topic type contains the actual learning content. In a <learningContent> topic, the main element is the <learningContentbody>
- element. The <learningContentbody> element can contain the following elements:<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" "learningAssessment.dtd">
- <learningAssessment id="lca_practice">
- <title>Feed Quality Source</title>
- <learningAssessmentbody>
-
+
+<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN"
+ "learningAssessment.dtd">
+<learningAssessment id="lca_practice">
+ <title>Feed Quality Source</title>
+ <learningAssessmentbody>
+
<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" "learningAssessment.dtd">
+
+<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN"
+ "learningAssessment.dtd">
<learningAssessment id="lca_practice">
<title>Feed Quality Source</title>
<learningAssessmentbody>
@@ -137,31 +150,33 @@
- . . .
- <lcMultipleSelect2>
-
- . . .
- <lcMultipleSelect2>
- <lcQuestion2>Good commercially prepared duck feed can be found where? (answer all that apply):</lcQuestion2>
- <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
- <lcAnswerOption2>
-
- . . .
- <lcQuestion>
- <lcMultipleSelect2>
- <lcQuestion2>Good commercially prepared duck feed can be found where? (answer all that apply):</lcQuestion2>
- <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
- <lcAnswerOption2>
- <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
-
- . . .
- <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
- <lcAnswerOption2>
- <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
- <lcCorrectResponse2/>
- </lcAnswerOption2>
-
- . . .
- <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
- <lcAnswerOption2>
- <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
- <lcCorrectResponse2/>
- </lcAnswerOption2>
- <lcAnswerOption2>
- <lcAnswerContent2>Mixed on the farm from bulk ingredients.</lcAnswerContent>
- <lcCorrectResponse2/>
- </lcAnswerOption2>
-
-
- These elements may be followed by an unlimited number of <section> elements.
These elements may be followed by an unlimited number of <section> elements.
The <learningContent> topic also allows you to use content from DITA task, concept, and reference topics. You can nest these directly within the <learningContent> topic or add them using a map. We will discuss this in further detail in the <learningContent> lesson, but it means that you can reference content written in standard DITA topics. If you were creating a course from a - previously written book, you could easily reference the existing DITA material to + previously written book, you could reference the existing DITA material to include in your course.
diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningContent_elements.dita b/en-us/Learning_and_training_specialization/topics/lc_learningContent_elements.dita index 9af33bf5..32033aa0 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningContent_elements.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningContent_elements.dita @@ -2,10 +2,11 @@Your instructional content might include a series of steps for the student to follow to complete an activity. In this case, you can embed a task topic within the <learningContent> topic to handle these steps:
-<learningContent id="watching_ducks"> - <title>Watching ducks</title> - <learningContentbody> - <lcInstruction> - <p>Read this to learn more about what you need to have a satisfying duck-watching experience.</p> - </lcInstruction> - </learningContentbody> - <task id="how_to_watch_ducks"> - <title>How to watch ducks</title> - <taskbody> - <steps id="steps_watching_ducks"> - <step> - <cmd>Choose a location to watch ducks.</cmd> - </step> - <step> - <cmd>Pick a field guide to identify the ducks.</cmd> - </step> - <step> - <cmd>Find some good optics.</cmd> - </step> ++<learningContent id="watching_ducks"> + <title>Watching ducks</title> + <learningContentbody> + <lcInstruction> + <p>Read this to learn more about what you need to have a satisfying + duck-watching experience.</p> + </lcInstruction> + </learningContentbody> + <task id="how_to_watch_ducks"> + <title>How to watch ducks</title> + <taskbody> + <steps id="steps_watching_ducks"> + <step> + <cmd>Choose a location to watch ducks.</cmd> + </step> + <step> + <cmd>Pick a field guide to identify the ducks.</cmd> + </step> + <step> + <cmd>Find some good optics.</cmd> + </step> </steps> - </taskbody> - </task> - </learningContent>+ </taskbody> + </task> +</learningContent>
There are several benefits to embedding a topic within a <learningContent> topic:
The <learningContent> topic type will likely contain the bulk of your instructional course content.
+The <learningContent> topic type will contain the bulk of your + instructional course content.
These elements may be followed by an unlimited number of <section> - elements.
+These elements may be followed by an unlimited number of <section> elements.
Here is an example of a <learningOverviewbody>:
-<learningOverviewbody>pre from "../LearningDITA/en-us/Learning_and_training_specialization/samples/lo_feedingducks.dita" - <lcAudience id="lcAudience_rth_l4r_rcb">This course is intended for current or future owners of small- to medium-sized flocks of domestic ducks.</lcAudience> - <lcDuration id="lcDuration_ohs_l4r_rcb"> - <lcTime value="3 weeks"/> - </lcDuration> - <lcObjectives id="lcObjectives_j3w_l4r_rcb"> - <lcObjectivesStem>At the end of this course, students will be able to:</lcObjectivesStem> - <lcObjectivesGroup id="lcObjectivesGroup_cdr_2pr_rcb"> - <lcObjective>List the most important aspects of feed quality.</lcObjective> - <lcObjective>Describe the common forms of feed and their pros and cons.</lcObjective> - <lcObjective>List the physical requirements of feeders and waterers.</lcObjective> - <lcObjective>Summarize macro and micro nutritional needs of ducks.</lcObjective> - <lcObjective>List the four most common diseases in ducks and how they can be controlled by feeding.</lcObjective> - <lcObjective>Identify the most common predators for ducks and how to limit predation</lcObjective> - </lcObjectivesGroup> - </lcObjectives> - </learningOverviewbody> ++<learningOverviewbody>diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningPlan_details.dita b/en-us/Learning_and_training_specialization/topics/lc_learningPlan_details.dita index 643c4d7c..19ee83d7 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningPlan_details.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningPlan_details.dita @@ -8,6 +8,8 @@ class="- topic/author ">Simon Bate, Scriptoriumpre from "../LearningDITA/en-us/Learning_and_training_specialization/samples/lo_feedingducks.dita" + <lcAudience id="lcAudience_rth_l4r_rcb">This course is intended for + current or future owners of small- to medium-sized flocks of + domestic ducks.</lcAudience> + <lcDuration id="lcDuration_ohs_l4r_rcb"> + <lcTime value="3 weeks"/> + </lcDuration> + <lcObjectives id="lcObjectives_j3w_l4r_rcb"> + <lcObjectivesStem>At the end of this course, students will be + able to:</lcObjectivesStem> + <lcObjectivesGroup id="lcObjectivesGroup_cdr_2pr_rcb"> + <lcObjective>List the most important aspects of feed + quality.</lcObjective> + <lcObjective>Describe the common forms of feed and their pros + and cons.</lcObjective> + <lcObjective>List the physical requirements of feeders and + waterers.</lcObjective> + <lcObjective>Summarize macro and micro nutritional needs of + ducks.</lcObjective> + <lcObjective>List the four most common diseases in ducks and how + they can be controlled by feeding.</lcObjective> + <lcObjective>Identify the most common predators for ducks and how + to limit predation</lcObjective> + </lcObjectivesGroup> + </lcObjectives> +</learningOverviewbody>Alan Pringle, Scriptorium +Kaitlyn Heath, Scriptorium @@ -28,22 +30,22 @@ topic. For example, to specify the description for a course, use the <lcPlanDescrip> element, which can contain paragraphs and unordered lists: - <lcPlanDescrip id="lcPlanDescrip_dnw_3bs_rcb"> - <title>Course Description</title> - <p>This course is intended for owners of small- to medium-sized flocks of domestic ducks. Topics covered include:</p> - <ul> - <li>Feed Quality<ul id="ul_i2d_lds_rcb"> - <li>Source</li> - <li>Protection</li> - <li>Contamination and spoilage</li> - </ul></li> - <li>Feed Form</li> - <li>Feeders and waterers</li> - <li>Nutritional requirements</li> - <li>Controlling disease</li> - <li>Avoiding predation</li> - </ul> - </lcPlanDescrip> +<lcPlanDescrip id="lcPlanDescrip_dnw_3bs_rcb"> + <title>Course Description</title> + <p>This course is intended for owners of small- to medium-sized flocks of domestic ducks. Topics covered include:</p> + <ul> + <li>Feed Quality<ul id="ul_i2d_lds_rcb"> + <li>Source</li> + <li>Protection</li> + <li>Contamination and spoilage</li> + </ul></li> + <li>Feed Form</li> + <li>Feeders and waterers</li> + <li>Nutritional requirements</li> + <li>Controlling disease</li> + <li>Avoiding predation</li> + </ul> +</lcPlanDescrip>Even though the L&T specialization contains elements exclusively for training content, these elements can contain DITA elements you use elsewhere in diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningSummary_details.dita b/en-us/Learning_and_training_specialization/topics/lc_learningSummary_details.dita index 4c1f880c..65e6d219 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningSummary_details.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningSummary_details.dita @@ -19,28 +19,34 @@
The <learningSummary> topic type contains review materials. This topic provides a review of the content and puts it in perspective with your learning objectives. This topic can also include instructions on what to do next.
-In a <learningSummary> topic, the main body element is the <learningSummarybody>. The <learningSummarybody> element can contain the following elements: -
-
- These elements may be followed by an unlimited number of <section> elements. - +- <lcSummary> summary of the learned goals
-- <lcObjectives> completed objectives
-- <lcReview> review of the main content
-- <lcNextSteps> directions for after the course
-- <lcResources> related information to the course
-In a <learningSummary> topic, the main body element is the + <learningSummarybody>. The <learningSummarybody> element can contain the + following elements:
++
+- <lcSummary> summary of the learned goals
+- <lcObjectives> completed objectives
+- <lcReview> review of the main content
+- <lcNextSteps> directions for after the course
+- <lcResources> related information to the course
+These elements may be followed by an unlimited number of <section> elements.
Here is an example of a <learningSummarybody>:
-<learningSummarybody>pre from "../LearningDITA/en-us/Learning_and_training_specialization/samples/ls_l3_t1_summary.dita" - <lcSummary id="lcSummary_igg_jd1_scb"> - <p>To summarize the overview of Feeders and Waterers:</p> - <ul id="ul_dhl_md1_scb"> - <li>The height of the feeders and waterers is important to the ducks’ development.</li> - <li>Feeders and waterers must be kept as clean as possible at all times.</li> - <li>Feeder and waterer space is important for the development of ducklings.</li> - <li>Ducks’ attraction to water can lead to wet litter problems.</li> - </ul> - </lcSummary> - </learningSummarybody> ++<learningSummarybody>diff --git a/en-us/Learning_and_training_specialization/topics/lc_learning_maps.dita b/en-us/Learning_and_training_specialization/topics/lc_learning_maps.dita index 4ea03583..f17073e4 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learning_maps.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learning_maps.dita @@ -2,12 +2,14 @@pre from "../LearningDITA/en-us/Learning_and_training_specialization/samples/ls_l3_t1_summary.dita" + <lcSummary id="lcSummary_igg_jd1_scb"> + <p>To summarize the overview of Feeders and Waterers:</p> + <ul id="ul_dhl_md1_scb"> + <li>The height of the feeders and waterers is important to + the ducks’ development.</li> + <li>Feeders and waterers must be kept as clean as possible + at all times.</li> + <li>Feeder and waterer space is important for the development + of ducklings.</li> + <li>Ducks’ attraction to water can lead to wet litter + problems.</li> + </ul> + </lcSummary> +</learningSummarybody>- Learning Maps +Learning maps Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium @@ -30,7 +32,9 @@ elements, but you cannot expect that they will be handled correctly by all processors. A learning object map has this structure:
-<!DOCTYPE learningObjectMap PUBLIC "-//OASIS//DTD DITA 1.3 Learning Object Map//EN" "learningObjectMap.dtd"> ++<!DOCTYPE learningObjectMap PUBLIC "-//OASIS//DTD DITA 1.3 Learning Object Map//EN" + "learningObjectMap.dtd"> <learningObjectMap> <learningObject> ... @@ -38,7 +42,9 @@ </learningObjectMap>A learningGroup map has this structure:
-<!DOCTYPE learningGroupMap PUBLIC "-//OASIS//DTD DITA 1.3 Learning Group Map//EN" "learningGroupMap.dtd"> ++<!DOCTYPE learningGroupMap PUBLIC "-//OASIS//DTD DITA 1.3 Learning Group Map//EN" + "learningGroupMap.dtd"> <learningGroupMap> <learningGroup> ... @@ -63,8 +69,10 @@
You should see this:
-<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE learningGroupMap PUBLIC "-//OASIS//DTD DITA Learning Group Map//EN" "learningGroupMap.rng"> ++<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE learningGroupMap PUBLIC "-//OASIS//DTD DITA Learning Group Map//EN" + "learningGroupMap.rng"> <learningGroupMap> </learningGroupMap>@@ -73,11 +81,12 @@@@ -88,27 +97,30 @@ plan (lp_feedingducks.dita) with the <learningPlanRef> element and the href attribute. You should give your map a title and place the main learning group. - <learningGroupMap> -<<title>Feeding Ducks</title> - <learningGroup> - </learningGroup> - </learningGroupMap> ++<learningGroupMap> +<<title>Feeding Ducks</title> + <learningGroup> + </learningGroup> +</learningGroupMap>- <learningGroupMap> - <<title>Feeding Ducks</title> - <learningGroup> -<learningPlanRef href="lp_feedingducks.dita"/> - </learningGroup> - </learningGroupMap> ++<learningGroupMap> + <title>Feeding Ducks</title> + <learningGroup> +<learningPlanRef href="../lp_feedingducks.dita"/> + </learningGroup> +</learningGroupMap>Notice how the reference element states the type of topic that it references: <learningPlanRef>. +Inside of the href attribute, make sure to add "../" to the beginning of a file name. Then if the filepath is change, your editor can still locate it. @@ -117,20 +129,21 @@ all of the topics for the first lesson, and give it a title in the map. Then you can reference the Feeding Ducks learning overview. - <learningGroupMap> - <<title>Feeding Ducks</title> - <learningGroup> - <learningPlanRef href="lp_feedingducks.dita"/> -<learingOverviewRef href="lo_feedingducks.dita"/> - </learningGroup> - </learningGroupMap> ++<learningGroupMap> + <title>Feeding Ducks</title> + <learningGroup> + <learningPlanRef href="../lp_feedingducks.dita"/> +<learingOverviewRef href="../lo_feedingducks.dita"/> + </learningGroup> +</learningGroupMap>- @@ -139,27 +152,28 @@ object for this. Create a <learningObject> within the Lesson 1 learning group and name it.<learningGroupMap> - <<title>Feeding Ducks</title> - <learningGroup> - <learningPlanRef href="lp_feedingducks.dita"/> - <learingOverviewRef href="lo_feedingducks.dita"/> - </learningGroup> - -<learningGroup> - <topicmeta> - <navtitle>Lesson 1: Feed Quality</navtitle> - </topicmeta> - </learningGroup> - - </learningGroupMap> ++<learningGroupMap> + <title>Feeding Ducks</title> + <learningGroup> + <learningPlanRef href="../lp_feedingducks.dita"/> + <learingOverviewRef href="../lo_feedingducks.dita"/> + </learningGroup> + +<learningGroup> + <topicmeta> + <navtitle>Lesson 1: Feed Quality</navtitle> + </topicmeta> + </learningGroup> + +</learningGroupMap>- @@ -169,31 +183,32 @@ content topics, learning summary, and the learning assessment by using the appropriate reference topics.<learningGroupMap> - <<title>Feeding Ducks</title> - <learningGroup> - <learningPlanRef href="lp_feedingducks.dita"/> - <learingOverviewRef href="lo_feedingducks.dita"/> - </learningGroup> - - <learningGroup> - <topicmeta> - <navtitle>Lesson 1: Feed Quality</navtitle> - </topicmeta> - -<learningObject> - <topicmeta> - <navtitle>Topic 1</navtitle> - </topicmeta> - </learningObject> - - </learningGroup> - - </learningGroupMap> ++<learningGroupMap> + <title>Feeding Ducks</title> + <learningGroup> + <learningPlanRef href="../lp_feedingducks.dita"/> + <learingOverviewRef href="../lo_feedingducks.dita"/> + </learningGroup> + + <learningGroup> + <topicmeta> + <navtitle>Lesson 1: Feed Quality</navtitle> + </topicmeta> + +<learningObject> + <topicmeta> + <navtitle>Topic 1</navtitle> + </topicmeta> + </learningObject> + + </learningGroup> + +</learningGroupMap>- <learningGroupMap> - . . . - <learningGroup> - <topicmeta> - <navtitle>Lesson 1: Feed Quality</navtitle> - </topicmeta> - - <learningObject> - <topicmeta> - <navtitle>Topic 1</navtitle> - </topicmeta> -<learningPlanRef href="lp_l1_t1_feed_quality.dita"/> - <learningOverviewRef href="lo_l1_t1_feed_quality.dita"/> - <learningContentRef href="lc_l1_t1_where_to_buy.dita"/> - <learningContentRef href="lc_l1_t1_storage.dita"/> - <learningContentRef href="lc_l1_t1_spoiling.dita"/> - <learningContentRef href="lc_l1_t1_ingredient_quality.dita"/> - <learningSummaryRef href="ls_l1_t1_summary.dita"/> - <learningPostAssessmentRef href="lg_l1_t1_quiz.dita" type="learningGroup"/> - - </learningObject> - - </learningGroup> - - </learningGroupMap> ++<learningGroupMap> + . . . + <learningGroup> + <topicmeta> + <navtitle>Lesson 1: Feed Quality</navtitle> + </topicmeta> + + <learningObject> + <topicmeta> + <navtitle>Topic 1</navtitle> + </topicmeta> +<learningPlanRef href="../lp_l1_t1_feed_quality.dita"/> + <learningOverviewRef href="../lo_l1_t1_feed_quality.dita"/> + <learningContentRef href="../lc_l1_t1_where_to_buy.dita"/> + <learningContentRef href="../lc_l1_t1_storage.dita"/> + <learningContentRef href="../lc_l1_t1_spoiling.dita"/> + <learningContentRef href="../lc_l1_t1_ingredient_quality.dita"/> + <learningSummaryRef href="../ls_l1_t1_summary.dita"/> + <learningPostAssessmentRef href="../lg_l1_t1_quiz.dita" type="learningGroup"/> + + </learningObject> + + </learningGroup> + +</learningGroupMap>You could add the appropriate number of learning objects and groups for diff --git a/en-us/Learning_and_training_specialization/topics/lc_learning_object_elements.dita b/en-us/Learning_and_training_specialization/topics/lc_learning_object_elements.dita index 47e4a4d5..67c2d737 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learning_object_elements.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learning_object_elements.dita @@ -2,12 +2,14 @@ - diff --git a/en-us/Learning_and_training_specialization/topics/lc_learning_overview.dita b/en-us/Learning_and_training_specialization/topics/lc_learning_overview.dita index 59af12ea..82cd3ccf 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learning_overview.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learning_overview.dita @@ -1,12 +1,14 @@Learning Object elements +Learning object elements Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium @@ -18,7 +20,8 @@ specific learning object. All of the reference elements inherit their behavior from the <topicref> element, but the L&T reference element names mirror the names of the topics that they reference. - A <learningObject> element can contain:
+
+A <learningObject> element can contain:
+-
An optional <learningPlanRef> element that indicates a learning plan topic.
@@ -44,22 +47,23 @@ assessment topics that reinforce the learning or to assess what the student learned.This is an example learning object from the Feeding Ducks example in your course materials:
-<learningObject> - <topicmeta> - <navtitle>Topic 1</navtitle> - </topicmeta> - <learningPlanRef href="lp_l1_t1_feed_quality.dita"/> - <learningOverviewRef href="lo_l1_t1_feed_quality.dita"/> - <learningContentRef href="lc_l1_t1_where_to_buy.dita"/> - <learningContentRef href="lc_l1_t1_storage.dita"/> - <learningContentRef href="lc_l1_t1_spoiling.dita"/> - <learningContentRef href="lc_l1_t1_ingredient_quality.dita"/> - <learningSummaryRef href="ls_l1_t1_summary.dita"/> - <learningPostAssessmentRef href="lg_l1_t1_quiz.dita" type="learningGroup"/> - </learningObject>++<learningObject> + <topicmeta> + <navtitle>Topic 1</navtitle> + </topicmeta> + <learningPlanRef href="lp_l1_t1_feed_quality.dita"/> + <learningOverviewRef href="lo_l1_t1_feed_quality.dita"/> + <learningContentRef href="lc_l1_t1_where_to_buy.dita"/> + <learningContentRef href="lc_l1_t1_storage.dita"/> + <learningContentRef href="lc_l1_t1_spoiling.dita"/> + <learningContentRef href="lc_l1_t1_ingredient_quality.dita"/> + <learningSummaryRef href="ls_l1_t1_summary.dita"/> + <learningPostAssessmentRef href="lg_l1_t1_quiz.dita" type="learningGroup"/> +</learningObject>- diff --git a/en-us/Learning_and_training_specialization/topics/lc_objects_and_groups_intro.dita b/en-us/Learning_and_training_specialization/topics/lc_objects_and_groups_intro.dita index 3440ca7c..8f8489d4 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_objects_and_groups_intro.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_objects_and_groups_intro.dita @@ -7,6 +7,8 @@ class="- topic/author ">Simon Bate, ScriptoriumDITA L&T specialization overview +DITA Learning and Training specialization overview Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium @@ -14,15 +16,14 @@ - - Explain the L&T specialization and its role in creating instructional materials -List the benefits of using the L&T specialization -Discuss applications for the L&T specialization -Describe how the L&T specialization supports curriculum development +Explain the Learning and Training specialization and its role in creating instructional materials +List the benefits of using the Learning and Training specialization +Discuss applications for the Learning and Training specialization +Describe how the Learning and Training specialization supports curriculum development Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium @@ -29,6 +31,8 @@ - + + diff --git a/en-us/Learning_and_training_specialization/topics/lc_planning_interactions.dita b/en-us/Learning_and_training_specialization/topics/lc_planning_interactions.dita index eaa4000a..407f9581 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_planning_interactions.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_planning_interactions.dita @@ -6,6 +6,7 @@Concept Guide on Reusable Learning Objects with Application to Soil, Water and Environmental Sciences +Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium diff --git a/en-us/Learning_and_training_specialization/topics/lc_topics__maps__and_domains.dita b/en-us/Learning_and_training_specialization/topics/lc_topics__maps__and_domains.dita index 7b266280..3f81654e 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_topics__maps__and_domains.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_topics__maps__and_domains.dita @@ -1,7 +1,7 @@ - diff --git a/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_groups.dita b/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_groups.dita index 591c07ef..916cff3a 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_groups.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_groups.dita @@ -8,6 +8,8 @@ class="- topic/author ">Simon Bate, ScriptoriumWhat is in the L&T specialization? +What is in the Learning and Training specialization? - diff --git a/en-us/Learning_and_training_specialization/topics/lc_types_intro.dita b/en-us/Learning_and_training_specialization/topics/lc_types_intro.dita index 28d69b89..abcb70bc 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_types_intro.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_types_intro.dita @@ -1,12 +1,14 @@ - The L&T topic types +The Learning and Training topic types Simon Bate, Scriptorium Alan Pringle, Scriptorium +Kaitlyn Heath, Scriptorium @@ -26,21 +28,21 @@ The DITA L&T specialization defines five topic types that contain - different types of course information:
+ different types of course information: +
+
- <learningPlan>: provides a framework for planning learning content.
- <learningOverview>: contains overall learning objectives and specifics for a course, such as audience, duration, and prerequisites.
- <learningContent>: contains the actual learning content.
- <learningSummary>: contains review materials.
- <learningAssessment>: contains exercises, quizzes, or tests.
-These topic types describe a wide range of information. Not everyone will use all of - these topic types. For example, the source content for LearningDITA lessons do not + these topic types. For example, the source content for LearningDITA lessons does not use the <learningPlan>, <learningOverview>, or <learningSummary> elements. However, your course development process may require those elements.
This lesson provides an overview of each topic type.
Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium @@ -17,40 +19,40 @@ The <learningGroup> element allows you to build a lesson, a course, or even a curriculum by referencing multiple learning objects.
A learning group is similar in structure to a learning object. However, instead of - containing references to learning content, the learning group can include:
+ containing references to learning content, the learning group can include: +
-
- Other learning groups
- References to learning groups
- Learning objects
- References to learning objects
Because the <learningGroup> element can contain other <learningGroup> elements, - it is quite flexible. However, its organization can also get quite convoluted. One + it is flexible. However, its organization can also get quite convoluted. One possible way to reduce the complexity of the <learningGroup> element is to use references to learning groups and learning objects rather than directly including those elements.
Here is an example of a <learningGroup> element with learning topic and object references:
- <learningGroup> - <topicmeta> - <navtitle>Feeders and Waterers</navtitle> - </topicmeta> - <learningOverviewRef href="lo_l3_feeders_waterers.dita"/> - - <learningObject> - <topicmeta> - <navtitle>Feeders and Waterers</navtitle> - </topicmeta> - <learningOverviewRef href="lo_l3_t1_feeders_waterers.dita"/> - <learningContentRef href="lc_l3_t1_height.dita"/> - <learningContentRef href="lc_l3_t1_cleanliness.dita"/> - <learningContentRef href="lc_l3_t1_ducklings.dita"/> - <learningContentRef href="lc_l3_t1_wet_litter.dita"/> - <learningSummaryRef href="ls_l3_t1_summary.dita"/> - <learningPostAssessmentRef href="lg_l3_t1_quiz.dita" type="learningGroup"/> - </learningObject> - - </learningGroup> +<learningGroup> + <topicmeta> + <navtitle>Feeders and Waterers</navtitle> + </topicmeta> + <learningOverviewRef href="lo_l3_feeders_waterers.dita"/> + + <learningObject> + <topicmeta> + <navtitle>Feeders and Waterers</navtitle> + </topicmeta> + <learningOverviewRef href="lo_l3_t1_feeders_waterers.dita"/> + <learningContentRef href="lc_l3_t1_height.dita"/> + <learningContentRef href="lc_l3_t1_cleanliness.dita"/> + <learningContentRef href="lc_l3_t1_ducklings.dita"/> + <learningContentRef href="lc_l3_t1_wet_litter.dita"/> + <learningSummaryRef href="ls_l3_t1_summary.dita"/> + <learningPostAssessmentRef href="lg_l3_t1_quiz.dita" type="learningGroup"/> + </learningObject> + +</learningGroup>diff --git a/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_objects.dita b/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_objects.dita index cb4ddb24..f273b052 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_objects.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_working_with_learning_objects.dita @@ -2,12 +2,14 @@- diff --git a/en-us/Learning_and_training_specialization/topics/where_do_you_use_the_l_t_specialization_.dita b/en-us/Learning_and_training_specialization/topics/where_do_you_use_the_l_t_specialization_.dita index b3e894c1..56f5e264 100644 --- a/en-us/Learning_and_training_specialization/topics/where_do_you_use_the_l_t_specialization_.dita +++ b/en-us/Learning_and_training_specialization/topics/where_do_you_use_the_l_t_specialization_.dita @@ -2,7 +2,7 @@Working with Learning Objects +Working with learning objects Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium +Kaitlyn Heath, Scriptorium @@ -20,11 +22,14 @@ collection of information objects that you can reuse and repurpose, depending on how you need to deliver your learning content. A learning object is a “discrete reusable collection of content used to present and - support a single learning objective.”
-Where is this quote from? + support a single learning objective” (OASIS, A learning objects approach to learning and training + content ).The L&T specialization implements learningObjects with the <learningObject> element. The <learningObject> element inherits its behavior from the - <topicref> element. It can contain references to the standard learning topics:
element. It can contain references to the standard learning topics: +
-
- Learning plan (only one per learning object)
- Learning overview topics
@@ -32,7 +37,6 @@- Learning content topics
- Learning summary topics
- L&T Specialization use cases +Learning and Training specialization use cases Simon Bate, Scriptorium @@ -33,7 +33,7 @@ mix of e-learning & printed classroom materialsIf the training and other content creating teams use DITA, all teams can develop and share content among groups. While actual presentation and discussion of materials might take different forms, both groups can share common blocks of - text, images, tables of data, etc. + text, images, tables of data, and so on. diff --git a/en-us/shared/topics/benefits_of_using_the_learning___training_specialization.dita b/en-us/shared/topics/benefits_of_using_the_learning___training_specialization.dita index dea46ebf..691bccaa 100644 --- a/en-us/shared/topics/benefits_of_using_the_learning___training_specialization.dita +++ b/en-us/shared/topics/benefits_of_using_the_learning___training_specialization.dita @@ -2,7 +2,7 @@- diff --git a/en-us/shared/topics/lc_general_housekeeping.dita b/en-us/shared/topics/lc_general_housekeeping.dita index 92a98d16..0e68d23d 100644 --- a/en-us/shared/topics/lc_general_housekeeping.dita +++ b/en-us/shared/topics/lc_general_housekeeping.dita @@ -27,7 +27,7 @@Benefits of using the L&T specialization +Benefits of using the Learning and Training specialization Simon Bate, Scriptorium @@ -16,21 +16,23 @@- The L&T Specialization allows training content to be used in - multiple ways. For example, a learning assessment topic could be used as a test for - students, and also contain conditional information for instructors, such as answer keys. - By applying different transformation scenarios to one set of topics, you can use them for multiple purposes.
-The L&T specialization, like the rest of DITA, uses semantic elements, - meaning that the names of the elements give insight to how they are used. For example, the - <table> element indicates that the elements contain the contents of a table. In the - L&T specialization, the semantic elements are specific to the specialization: the - <learningOverviewbody> element contains the body of a <learningOverview> - topic.
-The <learningObject> element can be used within the L&T specialization to group learning topics together into one learning object. Learning plans, - overviews, contents, assessments, and summaries for one lesson can be grouped - together into one learning object.
-The <learningObject> element also allows you to add any DITA content, - even if it was not created using L&T topics.
+The L&T specialization allows training content to be used in multiple ways. For + example, a learning assessment topic could be used to generate a test for students, + but it can also contain information to generate answer keys for instructors. By + applying different transformation scenarios to one set of topics, you can use them + for multiple purposes.
+The L&T specialization, like the rest of DITA, uses semantic elements, meaning + that the names of the elements give insight to how they are used. For example, the + <table> element indicates that the elements contain the contents of a table. In + the L&T specialization, the semantic elements are specific to the + specialization: the <learningOverviewbody> element contains the body of a + <learningOverview> topic.
+The <learningObject> element can be used within the L&T specialization to + group learning topics together into one learning object. Learning plans, overviews, + contents, assessments, and summaries for one lesson can be grouped together into one + learning object.
+The <learningObject> element also allows you to add any DITA content, even if it + was not created using L&T topics.
In the instructions and examples, we show you the DITA code for each sample file. Most DITA editors have auto-complete or other similar features to guide you through the process of adding elements (for example, if you type the opening tag of an - element, most DITA editors will automatically add the closing tag for you). + element, the editor will automatically add the closing tag for you). Therefore, you will probably not need to create every piece of code from scratch as you work. Our demo videos were created in
oXygen XML Editor and show the differences