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 @@ - diff --git a/en-us/Learning_and_training_specialization/assessments/learning_content/lca_contentbody2.dita b/en-us/Learning_and_training_specialization/assessments/learning_content/lca_contentbody2.dita index b35d4d61..d4180232 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_content/lca_contentbody2.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_content/lca_contentbody2.dita @@ -17,7 +17,8 @@ <lcObjectives> - One or more items you will complete upon finishing the content + A preliminary list of one or more purposes for the + content <lcChallenge> diff --git a/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_assessment_elements.dita b/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_assessment_elements.dita index 32798922..3c61adf6 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_assessment_elements.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_assessment_elements.dita @@ -1,7 +1,7 @@ - LearningAssessment Elements + LearningAssessment elements diff --git a/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_best_practices.dita b/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_best_practices.dita index 6f1f3858..ff59a229 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_best_practices.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_best_practices.dita @@ -1,7 +1,7 @@ - Assessment Best Practices + Assessment best practices diff --git a/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_single_select.dita b/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_single_select.dita index d8c6df29..12bbcfd8 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_single_select.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_domain/lca_single_select.dita @@ -8,11 +8,10 @@ Which element is the best fit for a question with a multiple-choice answer selection and only one correct answer? (pick one) - <lcMultipleSelect> + <lcSingleChoice2> - <lcSingleSelect> - It is better to use the single select question from the learningDomain2 + <lcMatching2> <lcSingleSelect2> @@ -20,9 +19,11 @@ <lcMultipleSelect2> + You may be able to use this interaction type and only mark one answer as correct, but it would make more sense to use <lcSingleSelect2> <lcMultipleChoice2> + This is not the correct name of an interaction element. diff --git a/en-us/Learning_and_training_specialization/assessments/learning_domain/learning_domain2.dita b/en-us/Learning_and_training_specialization/assessments/learning_domain/learning_domain2.dita index 57199da5..cca715f2 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_domain/learning_domain2.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_domain/learning_domain2.dita @@ -5,8 +5,8 @@ - It is preferable to use elements from learningDomain2 as opposed to the - first learningDomain. + It is better to use elements from learningDomain2 as opposed to the + initial learningDomain. True diff --git a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_l-maps-element2.dita b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_l-maps-element2.dita index 4132966b..67d7fd7f 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_l-maps-element2.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_l-maps-element2.dita @@ -12,8 +12,7 @@ - It is possible to place a <topicref> element within a <learningGroup> - element. + You can use the <topicref> element to reference other DITA topics from a <learningGroup> element. True diff --git a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_learningPlan.dita b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_learningPlan.dita index 3cd2e7d9..21a3bdf2 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_learningPlan.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_learningPlan.dita @@ -15,17 +15,17 @@ Select the correct way to write a reference to a learning plan within a learning object in a learning object map. (pick one) - <learningObjectRef href=”#.dita”/> + <learningObjectRef href=”file.dita”/> - <learningGroupRef href=”#.dita”/> + <learningGroupRef href=”file.dita”/> - <learningPlanRef href=”#.dita”/> + <learningPlanRef href=”file.dita”/> - <learningRef href=”#.dita”/> + <learningRef href=”file.dita”/> diff --git a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_object-name.dita b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_object-name.dita index 7dc3d9a7..8a3ca3d2 100644 --- a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_object-name.dita +++ b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_object-name.dita @@ -12,7 +12,7 @@ - Which element allows you to name a learning object? + Which element allows you to name a learning object? (pick one) <title/> diff --git a/en-us/Learning_and_training_specialization/assessments/topic_types/lca_assessment.dita b/en-us/Learning_and_training_specialization/assessments/topic_types/lca_assessment.dita index 66c63294..0c8fd2ae 100644 --- a/en-us/Learning_and_training_specialization/assessments/topic_types/lca_assessment.dita +++ b/en-us/Learning_and_training_specialization/assessments/topic_types/lca_assessment.dita @@ -3,7 +3,7 @@ - + learningAssessment @@ -15,20 +15,20 @@ - - You use the <learningAssessment> topic type for quizzes, assignments, and - other exercises (true/false). - - - True - - - - False - The <learningAssessment> topic type can be used for any type of question posed to the student, including quizzes and assignments. - - - + + You use the <learningAssessment> topic type for quizzes, assignments, and + other exercises (true/false). + + + True + + + + False + The <learningAssessment> topic type can be used for any type of question posed to the student, including quizzes and assignments. + + + diff --git a/en-us/Learning_and_training_specialization/assessments/topic_types/lca_plan.dita b/en-us/Learning_and_training_specialization/assessments/topic_types/lca_plan.dita index 41a8fda5..02358c18 100644 --- a/en-us/Learning_and_training_specialization/assessments/topic_types/lca_plan.dita +++ b/en-us/Learning_and_training_specialization/assessments/topic_types/lca_plan.dita @@ -10,19 +10,19 @@ - - You must create a <learningPlan> in order to use the L&T specialization. (true/false). - - - True - The <learningPlan> topic type is optional. - - - False - - - - + + You must create a <learningPlan> in order to use the L&T specialization. (true/false). + + + True + The <learningPlan> topic type is optional. + + + False + + + + diff --git a/en-us/Learning_and_training_specialization/maps/m_learningContent.ditamap b/en-us/Learning_and_training_specialization/maps/m_learningContent.ditamap index 25ae41c9..41647813 100644 --- a/en-us/Learning_and_training_specialization/maps/m_learningContent.ditamap +++ b/en-us/Learning_and_training_specialization/maps/m_learningContent.ditamap @@ -5,15 +5,16 @@ Learning Content - + + - Assessment for Elements for learning content + Assessment for <learningContent> diff --git a/en-us/Learning_and_training_specialization/maps/m_learningDomain2.ditamap b/en-us/Learning_and_training_specialization/maps/m_learningDomain2.ditamap index 57981cb1..372d9d71 100644 --- a/en-us/Learning_and_training_specialization/maps/m_learningDomain2.ditamap +++ b/en-us/Learning_and_training_specialization/maps/m_learningDomain2.ditamap @@ -5,7 +5,7 @@ Elements for questions and responses - + diff --git a/en-us/Learning_and_training_specialization/maps/m_learning_objects_and_groups.ditamap b/en-us/Learning_and_training_specialization/maps/m_learning_objects_and_groups.ditamap index cf4792b1..af0b7fff 100644 --- a/en-us/Learning_and_training_specialization/maps/m_learning_objects_and_groups.ditamap +++ b/en-us/Learning_and_training_specialization/maps/m_learning_objects_and_groups.ditamap @@ -4,10 +4,10 @@ Learning objects and learning groups - + - + diff --git a/en-us/Learning_and_training_specialization/maps/m_overview.ditamap b/en-us/Learning_and_training_specialization/maps/m_overview.ditamap index 3b0787ec..6490f8c6 100644 --- a/en-us/Learning_and_training_specialization/maps/m_overview.ditamap +++ b/en-us/Learning_and_training_specialization/maps/m_overview.ditamap @@ -4,7 +4,7 @@ Overview - + @@ -15,7 +15,7 @@ - Assessment for Learning and Training Overview + Assessment for Learning and Training overview diff --git a/en-us/Learning_and_training_specialization/maps/m_topic_types.ditamap b/en-us/Learning_and_training_specialization/maps/m_topic_types.ditamap index 62a78505..bfde9356 100644 --- a/en-us/Learning_and_training_specialization/maps/m_topic_types.ditamap +++ b/en-us/Learning_and_training_specialization/maps/m_topic_types.ditamap @@ -4,13 +4,14 @@ The Learning and Training topic types - + + diff --git a/en-us/Learning_and_training_specialization/samples/lesson4/lca_exercise_start.dita b/en-us/Learning_and_training_specialization/samples/lesson4/lca_exercise_start.dita index 9068875f..81e216b2 100644 --- a/en-us/Learning_and_training_specialization/samples/lesson4/lca_exercise_start.dita +++ b/en-us/Learning_and_training_specialization/samples/lesson4/lca_exercise_start.dita @@ -9,3 +9,4 @@ + diff --git a/en-us/Learning_and_training_specialization/samples/lesson5/learningGroups-practice.ditamap b/en-us/Learning_and_training_specialization/samples/lesson5/learningGroups-practice.ditamap index 330dddb1..0ea3cded 100644 --- a/en-us/Learning_and_training_specialization/samples/lesson5/learningGroups-practice.ditamap +++ b/en-us/Learning_and_training_specialization/samples/lesson5/learningGroups-practice.ditamap @@ -3,8 +3,8 @@ Feeding Ducks - - + + @@ -15,14 +15,14 @@ Topic 1 - - - - - - - - + + + + + + + + @@ -30,4 +30,4 @@ - \ No newline at end of file + diff --git a/en-us/Learning_and_training_specialization/samples/lesson5/object_samples/lo_feedingducks.dita b/en-us/Learning_and_training_specialization/samples/lesson5/object_samples/lo_feedingducks.dita new file mode 100644 index 00000000..6c35460f --- /dev/null +++ b/en-us/Learning_and_training_specialization/samples/lesson5/object_samples/lo_feedingducks.dita @@ -0,0 +1,23 @@ + + + + Course Overview for Feeding Ducks + + + This course is intended for current or future owners of small- to medium-sized flocks of domestic ducks. + + + + + At the end of this course, students will be able to: + + List the most important aspects of feed quality + Describe the common forms of feed and their pros and cons. + List the physical requirements of feeders and waterers + Summarize macro and micro nutritional needs of ducks. + List the four most common diseases in ducks and how they can be controled by feeding. + Identify the most common predators for ducks and how to limit predation + + + + diff --git a/en-us/Learning_and_training_specialization/samples/lesson5/object_samples/lp_feedingducks.dita b/en-us/Learning_and_training_specialization/samples/lesson5/object_samples/lp_feedingducks.dita new file mode 100644 index 00000000..afe14ae2 --- /dev/null +++ b/en-us/Learning_and_training_specialization/samples/lesson5/object_samples/lp_feedingducks.dita @@ -0,0 +1,42 @@ + + + + Plan for Feeding Ducks + + + + + +

Feeding Ducks

+
+ + + + Course subject +

How to feed a small- to medium -sized flock of domestic ducks.

+
+ + Course Description +

This course is intended for owners of small- to medium-sized flocks of domestic ducks. Topics covered include:

+
    +
  • Feed Quality
      +
    • Source
    • +
    • Protection
    • +
    • Contamination and spoilage
    • +
  • +
  • Feed Form
  • +
  • Feeders and waterers
  • +
  • Nutritional requirements
  • +
  • Controlling disease
  • +
  • Avoiding predation
  • +
+
+
+ + Needs analysis + + + + +
+
diff --git a/en-us/Learning_and_training_specialization/topics/l_t_and_curriculum_development.dita b/en-us/Learning_and_training_specialization/topics/l_t_and_curriculum_development.dita index 774572b3..3523fc49 100644 --- a/en-us/Learning_and_training_specialization/topics/l_t_and_curriculum_development.dita +++ b/en-us/Learning_and_training_specialization/topics/l_t_and_curriculum_development.dita @@ -2,7 +2,7 @@ - L&T and curriculum development + Learning and Training and curriculum development Simon Bate, Scriptorium @@ -16,18 +16,18 @@

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.

+ 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.

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:

  • <lcIntro>
  • <lcObjectives>
  • <lcSummary>

-

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:

    -
  • A question
  • -
  • Images (optional)
  • -
  • Correct and incorrect answer element tags
  • -
  • Feedback for correct and incorrect answers (optional)
  • -

+

Interactions in the learningDomain2 can include the following parts:

+
    +
  • A question
  • +
  • Images (optional)
  • +
  • Correct and incorrect answer element tags
  • +
  • Feedback for correct and incorrect answers (optional)
  • +

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:

    + questions have different elements:

    +
    • <lcTrueFalse2>: true-false question
    • <lcSingleSelect2>: multiple-choice question with a single correct answer
    • @@ -41,28 +43,31 @@ short answer or essay responses)
    • <lcHotspot2>: an image with mapped regions on which students must click
    • -

    +

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. @@ -90,12 +97,14 @@

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 @@ Inside the <learningAssessmentbody> add the <lcInteraction> element and give it an id attribute. -

<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" "learningAssessment.dtd">
-                            <learningAssessment id="lca_practice">
-                                <title>Feed Quality Source</title>
-                                <learningAssessmentbody>
-                                    <lcInteraction id="lcInteraction_practice"> 
-                                    </lcInteraction>
-                                </learningAssessmentbody>
-                            </learningAssessment>
+
+<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" 
+    "learningAssessment.dtd">
+<learningAssessment id="lca_practice">
+    <title>Feed Quality Source</title>
+    <learningAssessmentbody>
+        <lcInteraction id="lcInteraction_practice"> 
+        </lcInteraction>
+    </learningAssessmentbody>
+</learningAssessment>
Now you can decide what type of assessment question you will add. For this practice exercise, add a <lcMultipleSelect2> question. -
<!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 @@
                     Next, you can add the question into the <lcQuestion2> element.
                     
                         
-                            . . .
-        <lcMultipleSelect2>
-            <lcQuestion2>Good commercially prepared duck feed can be found where? (answer all that apply):</lcQuestion2>
-        </lcMultipleSelect2>
-        . . .
+. . .
+<lcMultipleSelect2>
+    <lcQuestion2>Good commercially prepared duck feed can be found where? 
+                (answer all that apply):</lcQuestion2>
+</lcMultipleSelect2>
+. . .
                         
- Now you can start adding the group of answer choices. First, add the + Start adding the group of answer choices. First, add the <lcAnswerOptionGroup2> element and an id. Then, add the <lcAnswerOption2> element and the <lcAnswerContent2> element with the text of the first answer option.
-                            . . .
-        <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>
-                     </lcAnswerOption2>
-                </lcAnswerOptionGroup2>
-        </lcMultipleSelect2>
-                            . . .
+. . .
+<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>
+             </lcAnswerOption2>
+        </lcAnswerOptionGroup2>
+</lcMultipleSelect2>
+. . .
                         
@@ -170,18 +185,17 @@ choice.
-                            . . .
-                            <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>
-                        <lcCorrectResponse2/>
-                     </lcAnswerOption2>
-                </lcAnswerOptionGroup2>
-            </lcMultipleSelect2>
-                            . . .
+. . .
+<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>
+                <lcCorrectResponse2/>
+             </lcAnswerOption2>
+        </lcAnswerOptionGroup2>
+</lcMultipleSelect2>
+. . .
                         
You can add as many <lcAnswerOption2> elements as you need, and all of @@ -191,44 +205,47 @@ Try adding another correct answer option.
-                            . . .
-                <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
-                    <lcAnswerOption2>
-                        <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
-                        <lcCorrectResponse2/>
-                     </lcAnswerOption2>
-                     <lcAnswerOption2>
-                        <lcAnswerContent2>Mixed on the farm from bulk ingredients.</lcAnswerContent>
-                        <lcCorrectResponse2/>
-                     </lcAnswerOption2>
-                </lcAnswerOptionGroup2>
-                            . . .
+. . .
+<lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
+    <lcAnswerOption2>
+        <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
+        <lcCorrectResponse2/>
+     </lcAnswerOption2>
+     <lcAnswerOption2>
+        <lcAnswerContent2>Mixed on the farm from bulk 
+                             ingredients.</lcAnswerContent2>
+        <lcCorrectResponse2/>
+     </lcAnswerOption2>
+</lcAnswerOptionGroup2>
+. . .
                         
- To create an answer choice that is not a correct answer, just omit the + To create an answer choice that is not a correct answer, omit the <lcCorrectResponse/> element. Then, provide feedback by using the <lcFeedback2> element.(It will appear if the student chooses the wrong answer.)
-                        . . .
-                         <lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
-                    <lcAnswerOption2>
-                        <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
-                        <lcCorrectResponse2/>
-                     </lcAnswerOption2>
-                     <lcAnswerOption2>
-                        <lcAnswerContent2>Mixed on the farm from bulk ingredients.</lcAnswerContent>
-                        <lcCorrectResponse2/>
-                     </lcAnswerOption2>
-                     <lcAnswerOption2>
-                        <lcAnswerContent2>From the back of a stranger’s truck.</lcAnswerContent2>
-                        <lcFeedback2>The more you know about the source, age, storage history, and the seller, the better off you are. The back of a stranger's truck has none of this information.</lcFeedback2>
-                    </lcAnswerOption2>
-                </lcAnswerOptionGroup2>
-                        . . .
+. . .
+<lcAnswerOptionGroup2 id="lcAnswerOptionGroup2_practice">
+    <lcAnswerOption2>
+        <lcAnswerContent2>Local feed stores.</lcAnswerContent2>
+        <lcCorrectResponse2/>
+    </lcAnswerOption2>
+    <lcAnswerOption2>
+        <lcAnswerContent2>Mixed on the farm from bulk ingredients.</lcAnswerContent>
+        <lcCorrectResponse2/>
+    </lcAnswerOption2>
+    <lcAnswerOption2>
+        <lcAnswerContent2>From the back of a stranger’s truck.</lcAnswerContent2>
+        <lcFeedback2>The more you know about the source, age, storage history, and the seller,
+                        the better off you are. The back of a stranger's truck has none of this
+                        information.</lcFeedback2>
+    </lcAnswerOption2>
+</lcAnswerOptionGroup2>
+. . .
                     
diff --git a/en-us/Learning_and_training_specialization/topics/lc_learning-domain_intro.dita b/en-us/Learning_and_training_specialization/topics/lc_learning-domain_intro.dita index b637d525..287d00b4 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learning-domain_intro.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learning-domain_intro.dita @@ -7,6 +7,8 @@ class="- topic/author ">Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium + Kaitlyn Heath, Scriptorium @@ -16,7 +18,8 @@ Understand the uses of the <learningAssessment> topic. Use various elements to create different question types. - Plan question formatting with DITA L&T standards in mind. + Plan question formatting with DITA L&T standards in + mind. @@ -28,6 +31,9 @@ - + + Support for learningDomain1 and learningDomain2 + diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningAssessment_details.dita b/en-us/Learning_and_training_specialization/topics/lc_learningAssessment_details.dita index f2986c9d..ee6188da 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningAssessment_details.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningAssessment_details.dita @@ -8,6 +8,8 @@ class="- topic/author ">Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium + Kaitlyn Heath, Scriptorium diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningContent_details.dita b/en-us/Learning_and_training_specialization/topics/lc_learningContent_details.dita index 1a4048f2..ad5cb289 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningContent_details.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningContent_details.dita @@ -18,20 +18,22 @@

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:

    -
  1. <lcIntro>: introduction to the content
  2. -
  3. <lcDuration>: estimated time to complete the following content
  4. -
  5. <lcObjectives>: what students should gain from the content in the topic
  6. -
  7. <lcChallenge>: explaination of what you want the student to practice
  8. -
  9. <lcInstruction>: the bulk of instructional content
  10. -
- These elements may be followed by an unlimited number of <section> elements.

+ element. The <learningContentbody> element can contain the following + elements:

+
    +
  1. <lcIntro>: introduction to the content
  2. +
  3. <lcDuration>: estimated time to complete the following content
  4. +
  5. <lcObjectives>: what students should gain from the content in the topic
  6. +
  7. <lcChallenge>: explaination of what you want the student to practice
  8. +
  9. <lcInstruction>: the instructional content
  10. +
+

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 @@ - The <learningContent elements> + The <learningContent> elements Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium + Kaitlyn Heath, Scriptorium diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningContent_embedded_topics.dita b/en-us/Learning_and_training_specialization/topics/lc_learningContent_embedded_topics.dita index d1f3c35f..0584601c 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningContent_embedded_topics.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningContent_embedded_topics.dita @@ -21,30 +21,32 @@

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:

  • Reuse. If you need to reuse content in your training materials, embedding diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningContent_intro.dita b/en-us/Learning_and_training_specialization/topics/lc_learningContent_intro.dita index 384f9398..e24d4681 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningContent_intro.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningContent_intro.dita @@ -4,9 +4,12 @@ Learning content - Simon Bate, Scriptorium - Gretyl Kinsey, Scriptorium - Kaitlyn Heath, Scriptorium + Simon Bate, Scriptorium + Gretyl Kinsey, Scriptorium + Kaitlyn Heath, Scriptorium @@ -14,17 +17,22 @@ - Describe the two common organizations of learning content. - Properly order elements within the <learningContentbody> element. - Give examples of when it is useful to use <learningContent> with an embedded topic. - Author an embedded task topic in a <learningContent> topic. + Describe the two common organizations of learning + content. + Properly order elements within the <learningContentbody> + element. + Give examples of when it is useful to use <learningContent> with an + embedded topic. + Author an embedded task topic in 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.

    diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningContent_topic_type.dita b/en-us/Learning_and_training_specialization/topics/lc_learningContent_topic_type.dita index e830e57b..377e3806 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningContent_topic_type.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningContent_topic_type.dita @@ -2,12 +2,14 @@ - The <learningContent> topic type + The <learningContent> topic Simon Bate, Scriptorium Gretyl Kinsey, Scriptorium + Kaitlyn Heath, Scriptorium diff --git a/en-us/Learning_and_training_specialization/topics/lc_learningOverview_details.dita b/en-us/Learning_and_training_specialization/topics/lc_learningOverview_details.dita index f2625ace..499640a6 100644 --- a/en-us/Learning_and_training_specialization/topics/lc_learningOverview_details.dita +++ b/en-us/Learning_and_training_specialization/topics/lc_learningOverview_details.dita @@ -22,35 +22,42 @@ <learningOverviewbody>. This element can contain the following elements in this order:

      -
    1. <lcIntro>: introduction to the overview
    2. -
    3. <lcAudience>: facts about the students for whom the course is intended
    4. -
    5. <lcDuration>: estimated time to complete the course
    6. -
    7. <lcPrereqs>: any requirements for students before they take the - course
    8. -
    9. <lcObjectives>: what students should gain from the course
    10. -
    11. <lcResources>: any resources used or extra information for the - course
    12. -
    -

    These elements may be followed by an unlimited number of <section> - elements.

    +
  • <lcIntro>: introduction to the overview
  • +
  • <lcAudience>: facts about the students for whom the course is intended
  • +
  • <lcDuration>: estimated time to complete the course
  • +
  • <lcPrereqs>: any requirements for students before they take the course
  • +
  • <lcObjectives>: what students should gain from the course
  • +
  • <lcResources>: any resources used or extra information for the course
  • + +

    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>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>
                 
    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, Scriptorium 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: -

      -
    1. <lcSummary> summary of the learned goals
    2. -
    3. <lcObjectives> completed objectives
    4. -
    5. <lcReview> review of the main content
    6. -
    7. <lcNextSteps> directions for after the course
    8. -
    9. <lcResources> related information to the course
    10. -
    - These elements may be followed by an unlimited number of <section> elements. -

    +

    In a <learningSummary> topic, the main body element is the + <learningSummarybody>. The <learningSummarybody> element can contain the + following elements:

    +
      +
    1. <lcSummary> summary of the learned goals
    2. +
    3. <lcObjectives> completed objectives
    4. +
    5. <lcReview> review of the main content
    6. +
    7. <lcNextSteps> directions for after the course
    8. +
    9. <lcResources> related information to the course
    10. +
    +

    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> 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>
                     
                 
    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 @@ - 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 @@ 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>
                             
    @@ -88,27 +97,30 @@ plan (lp_feedingducks.dita) with the <learningPlanRef> element and the href attribute. -
    <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. 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>
                             
    @@ -117,20 +129,21 @@ all of the topics for the first lesson, and give it a title in the map. -
    <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>
                             
    @@ -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>
    -                                    
    -                                    <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>
                             
    @@ -169,31 +183,32 @@ content topics, learning summary, and the learning assessment by using the appropriate reference topics. -
    <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 @@ - 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_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 @@ - DITA 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 - 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, Scriptorium Gretyl Kinsey, Scriptorium + Kaitlyn Heath, Scriptorium @@ -29,6 +31,8 @@ - + + Concept Guide on Reusable Learning Objects with Application to Soil, Water and Environmental Sciences + 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 @@ 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 @@ - What 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.

-
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, Scriptorium 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 @@ - 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
      -

      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 @@ - L&T Specialization use cases + Learning and Training specialization use cases Simon Bate, Scriptorium @@ -33,7 +33,7 @@ mix of e-learning & printed classroom materials
    • If 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 @@ - 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.

    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 @@

    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