Edits: round 2

nili1 · Sep 18, 2018 · 9d361d2 · 9d361d2
1 parent e16074b
commit 9d361d2
Show file tree

Hide file tree

Showing 21 changed files with 120 additions and 76 deletions.
diff --git a/en-us/Learning_and_training_specialization.ditamap b/en-us/Learning_and_training_specialization.ditamap
@@ -9,6 +9,7 @@
    <created date="2017-04-20"/>
   </critdates>
  </topicmeta>
+ <topicref href="Learning_and_training_specialization/topics/lc_l-and-t_intro.dita"></topicref>
  <mapref href="Learning_and_training_specialization/maps/m_overview.ditamap"/>
  <mapref href="Learning_and_training_specialization/maps/m_topic_types.ditamap"/>
  <mapref href="Learning_and_training_specialization/maps/m_learningContent.ditamap"/>

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
@@ -4,26 +4,21 @@
     <title>LearningDomain2</title>
     <learningAssessmentbody>
         <lcInteraction>
-            <lcMultipleSelect id="learningdomain2">
-                <lcQuestion>Why is it preferable to use elements from learningDomain2 as opposed to the first learningDomain? (select all that apply)</lcQuestion>
+            <lcTrueFalse id="all-above">
+                <lcQuestion>It is preferable to use elements from learningDomain2 as opposed to the
+                    first learningDomain.</lcQuestion>
                 <lcAnswerOptionGroup>
                     <lcAnswerOption>
-                        <lcAnswerContent>It is actually preferable to use the first learningDomain.</lcAnswerContent>
-                    </lcAnswerOption>
-                    <lcAnswerOption>
-                        <lcAnswerContent>The learningDomain2 supports block elements.</lcAnswerContent>
-                        <lcCorrectResponse/>
-                    </lcAnswerOption>
-                    <lcAnswerOption>
-                        <lcAnswerContent>The learningDomain2 can include &lt;p> (paragraph) tags within answer choices.</lcAnswerContent>
+                        <lcAnswerContent>True</lcAnswerContent>
                         <lcCorrectResponse/>
                     </lcAnswerOption>
                     <lcAnswerOption>
-                        <lcAnswerContent>You cannot include multiple select questions in the first learingDomain.</lcAnswerContent>
+                        <lcAnswerContent>False</lcAnswerContent>
                     </lcAnswerOption>
                 </lcAnswerOptionGroup>
-                <lcFeedbackIncorrect></lcFeedbackIncorrect>
-            </lcMultipleSelect>
+                <lcFeedbackIncorrect>It is preferable to use elements from learningDomain2 since it supports block elements like paragraphs.</lcFeedbackIncorrect>
+            </lcTrueFalse>
+
         </lcInteraction>
     </learningAssessmentbody>
 </learningAssessment>
diff --git a/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_map-elements.dita b/en-us/Learning_and_training_specialization/assessments/learning_maps/lca_map-elements.dita
@@ -30,7 +30,8 @@
                         <lcCorrectResponse/>
                     </lcAnswerOption>
                     <lcAnswerOption>
-                        <lcAnswerContent>You can refernece learning group elements within a learning object map.</lcAnswerContent>
+                        <lcAnswerContent>You can reference learning group elements within a learning
+                            object map.</lcAnswerContent>
                     </lcAnswerOption>
                 </lcAnswerOptionGroup>
             </lcMultipleSelect>

diff --git a/en-us/Learning_and_training_specialization/assessments/learning_overview/lca_pdf-out.dita b/en-us/Learning_and_training_specialization/assessments/learning_overview/lca_pdf-out.dita
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE learningAssessment PUBLIC "-//OASIS//DTD DITA Learning Assessment//EN" "learningAssessment.dtd">
+<learningAssessment id="lca_pdf-out">
+    <title>output</title>
+    <learningAssessmentbody>
+        <lcInteraction>
+            <lcTrueFalse id="t-f-pdf">
+                <lcQuestion>You can generate PDF output from the L&amp;T specialization with the DITA Open Toolkit</lcQuestion>
+                <lcAnswerOptionGroup>
+                    <lcAnswerOption>
+                        <lcAnswerContent>True</lcAnswerContent>
+                        <lcCorrectResponse/>
+                    </lcAnswerOption>
+                    <lcAnswerOption>
+                        <lcAnswerContent>False</lcAnswerContent>
+                    </lcAnswerOption>
+                </lcAnswerOptionGroup>
+                <lcFeedbackIncorrect>While there is no default course output type, you can still use the DITA OT to generate a PDF.</lcFeedbackIncorrect>
+            </lcTrueFalse>
+        </lcInteraction>
+    </learningAssessmentbody>
+</learningAssessment>
diff --git a/...earning_and_training_specialization/assessments/learning_overview/lca_specialization.dita b/...earning_and_training_specialization/assessments/learning_overview/lca_specialization.dita
@@ -11,7 +11,7 @@
     <learningAssessmentbody>
         <lcInteraction>
             <lcTrueFalse id="t-f-sepcialization">
-                <lcQuestion>You must create specializations for elements in order to write an
+                <lcQuestion>You must create specializations for elements to write an
                     assessment.</lcQuestion>
                 <lcAnswerOptionGroup>
                     <lcAnswerOption>

diff --git a/en-us/Learning_and_training_specialization/maps/m_learningDomain2.ditamap b/en-us/Learning_and_training_specialization/maps/m_learningDomain2.ditamap
@@ -20,6 +20,7 @@
        <topicref href="../assessments/learning_domain/lca_assessment_order.dita"/>
        <topicref href="../assessments/learning_domain/lca_assessment_elements.dita"/>
        <topicref href="../assessments/learning_domain/lca_best_practices.dita"/>
+       <topicref href="../assessments/learning_domain/learning_domain2.dita"/>
    </topicref>
    </topicref>
 </map>
diff --git a/en-us/Learning_and_training_specialization/maps/m_overview.ditamap b/en-us/Learning_and_training_specialization/maps/m_overview.ditamap
@@ -21,6 +21,7 @@
    <topicref href="../assessments/learning_overview/lca_lms.dita"/>
    <topicref href="../assessments/learning_overview/lca_benefits.dita"/>
    <topicref href="../assessments/learning_overview/lca-ditacompatible.dita"/>
+   <topicref href="../assessments/learning_overview/lca_pdf-out.dita"/>
   </topicref>
  </topicref>
  <!-- TESTING THIS FILE -->

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
@@ -15,21 +15,19 @@
     <learningContentbody>
         <lcInstruction id="lcInstruction_js5_cqb_yz">
             <p>The L&amp;T specialization enables you to create learning materials, including
-                content and assessments, without modifications. </p>
-            <p>However, you might prefer a formalized approach, creating your content after careful
+                content and assessments.</p>
+            <p>You might prefer a formalized approach, creating your content after careful
                 planning and analysis. The L&amp;T specialization includes a planning topic type
                 that allows you to identify goals, needs, and objectives. The &lt;learningGroup> and
                 &lt;learningObject> elements allow you to use planning topic types at many levels of
                 your development. </p>
-            <p>In addition, the L&amp;T specialization allows you to create learning objects
-                (objective, content, assessment).</p>
             <!--Not sure this is the best place for the following, but I'll park it here for now.-->
             <p>The L&amp;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 plug-in that can replace a learning management system.</p>
+                formats, there is no default course output type.</p>
         </lcInstruction>
     </learningContentbody>
 </learningContent>
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
@@ -23,6 +23,9 @@
                     <li>Correct and incorrect answer element tags</li>
                     <li>Feedback for correct and incorrect answers (optional)</li>
                 </ul></p>
+            <p>Notice the use of 2 as in learningDomain2, lcTrueFalse2, and so on. An earlier
+                version of L&amp;T used &lt;learningDomain>. The &lt;learningDomain2> elements are
+                more flexible and allow block elements like &lt;p> within question elements.</p>
             <p>The bulk of the interaction will be the question content. Different types of
                 questions have different elements: <ul>
                     <li>&lt;lcTrueFalse2>: true-false question</li>
@@ -39,9 +42,6 @@
                     <li>&lt;lcHotspot2>: an image with mapped regions on which students must
                         click</li>
                 </ul></p>
-            <note>Notice the use of 2 as in learningDomain2, lcTrueFalse2, and so on. An earlier
-                version of L&amp;T used &lt;learningDomain>. The &lt;learningDomain2> elements are
-                more flexible and allow block elements like &lt;p> within question elements.</note>
             <p>Below is an example of a single select question.</p>
             <pre>&lt;learningAssessment id="la_l1_t1_ingredient_quality"><!-- from file:/C:/Users/kheat/Documents/GitHub/New%20folder/LearningDITA/en-us/Learning_and_training_specialization/samples/la_l1_t1_ingredient_quality.dita -->
     &lt;title>Ingredient quality&lt;/title>
@@ -245,7 +245,7 @@
                 <step>
                     <cmd>Now try an exercise on your own. Open the file
                         lesson3/lc_task_exercise_start.dita and use it to convert the following
-                        content from <xref
+                        assessment question from <xref
                             href="https://learningdita.com/courses/the-dita-task-topic-type/">The
                             DITA task topic type</xref> LearningDITA course into a DITA
                         &lt;learningAssessment> topic.</cmd>

diff --git a/en-us/Learning_and_training_specialization/topics/lc_l-and-t_intro.dita b/en-us/Learning_and_training_specialization/topics/lc_l-and-t_intro.dita
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE learningContent PUBLIC "-//OASIS//DTD DITA Learning Content//EN" "learningContent.dtd">
+<learningContent id="lc_l&amp;t_intro">
+    <title/>
+    <learningContentbody>
+        <lcIntro>
+            <p>This five-lesson course introduces you to the Learning and Training specialization in
+                DITA, including how to create courses and assessments.</p>
+            <p>This course builds on previous courses. Before starting this course we recommend that
+                you at least take these courses: <xref
+                    href="https://learningdita.com/courses/introduction-to-dita/">Introduction to
+                    DITA</xref>, <xref
+                    href="https://learningdita.com/courses/the-dita-task-topic-type/">The DITA task
+                    topic type</xref>, <xref
+                    href="https://learningdita.com/courses/using-dita-maps-and-bookmaps/">Using DITA
+                    maps and bookmaps</xref>, and <xref
+                    href="https://learningdita.com/courses/intro-to-reuse-in-dita/">Introduction to
+                    reuse in DITA</xref>.</p>
+        </lcIntro>
+    </learningContentbody>
+</learningContent>
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
@@ -16,12 +16,12 @@
         <lcInstruction id="lcInstruction_js5_cqb_yz">
             <p>The &lt;learningAssessment> topic type contains exercises, quizzes, or tests. This
                 information can be included before learning content as a preliminary test, or after
-                content to re-enforce content or assess understanding.</p>
+                content to reinforce content or assess understanding.</p>
             <p>The assessment type includes several interaction types that you can use to present
                 questions. The interaction types include true-false, multiple-choice, open question,
                 matching, sequence, and hot-spot (which allows the student to click on the
                 designated area of an image). If these questions are meant for an interactive
-                e-learning environment, it will require a specific output type as well as a learning
+                e-learning environment,you will need a specific output type as well as a learning
                 management system (LMS).</p>
             <p>The main body element is the &lt;learningAssessmentbody> which can include &lt;lcIntro>,
                 &lt;lcObjectives>, &lt;lcDuration>, &lt;lcInteraction>, &lt;section>, and &lt;lcSummary> elements. Questions

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
@@ -30,9 +30,9 @@
                 concept, and reference topics. You can nest these directly within the
                 &lt;learningContent> topic or add them using a map. We will discuss this in further
                 detail in the &lt;learningContent> lesson, but it means that you can reference
-                previous material from outside of the L&amp;T specialization. If you were creating a
-                course from a previously written book, you could easily reference the existing DITA
-                material to include in your course.</p>
+                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
+                include in your course.</p>
         </lcInstruction>
     </learningContentbody>
 </learningContent>
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
@@ -58,10 +58,10 @@
                     &lt;steps> element inside &lt;lcInstruction> for step-by-step instruction, but the &lt;steps> element is available inside an
                     embedded task topic.</li>
                 <li><i>Flexibility.</i> You can embed more than one topic into the body of a
-                    &lt;learningContent> topic, which adds flexibility to your &lt;learningContent> topics; for
-                    example, you might embed a concept topic to explain an idea to your students,
-                    and then embed a task topic to provide hands-on instructions to enhance their
-                    understanding of that concept.</li>
+                    &lt;learningContent> topic, which adds flexibility to your &lt;learningContent>
+                    topics. For example, you might embed a concept topic to explain an idea to your
+                    students, and then embed a task topic to provide hands-on instructions to
+                    enhance their understanding of that concept.</li>
             </ul>
         </lcInstruction>
     </learningContentbody>
@@ -71,10 +71,10 @@
             <steps id="steps_h5t_ljx_tcb">
                 <step>
                     <cmd>Open the file lesson3/lc_task_exercise_start.dita and use it to convert the
-                        following content from <xref
+                        following content from a LearningDITA course, <xref
                             href="https://learningdita.com/courses/the-dita-task-topic-type/">The
-                            DITA task topic type</xref> LearningDITA course into a DITA
-                        &lt;learningConcept> topic with an embedded task.</cmd>
+                            DITA task topic type</xref>, into a DITA &lt;learningConcept> topic with
+                        an embedded task.</cmd>
                     <info>
                         <pre outputclass="passthru">
                             <![CDATA[

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
@@ -15,9 +15,11 @@
     <learningContentbody>
         <lcInstruction id="lcInstruction_js5_cqb_yz">
             <p>The &lt;learningContent> topic type contains the instructional content of a course.
-                Depending on how your course is structured, a &lt;learningContent> topic can serve as a
-                single topic within a lesson or a lesson within a course by organizing the &lt;learningContent> topic within a map; or it can serve as an entire (short)
-                course if you embed other topic types like a &lt;task> or &lt;learningAssessment> within one &lt;learningContent> topic.</p>
+                Depending on how your course is structured, a &lt;learningContent> topic can serve
+                as a single topic within a lesson or a lesson within a course by organizing the
+                &lt;learningContent> topic within a map. It can also serve as an entire (short)
+                course if you embed other topic types like a &lt;task> or &lt;learningAssessment>
+                within one &lt;learningContent> topic.</p>
             <p>The instructional content is written in the main body element, &lt;learningContentbody>, or it can
                 be written in other DITA topics that can be nested within the &lt;learningContent> topic.</p>
         </lcInstruction>

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
@@ -17,17 +17,22 @@
     <learningContentbody>
         <lcInstruction id="lcInstruction_js5_cqb_yz">
             <p>The &lt;learningOverview> topic type contains objectives and prerequisites. It
-                describes the learning objectives , course prerequisites , and intended audience .</p>
-            <p>In a &lt;learningOverview> topic the main body-level element is the &lt;learningOverviewbody>. This element can conatain the following elements in this order:
-                <ol>
+                describes the learning objectives, course prerequisites, and intended audience.</p>
+            <p>In a &lt;learningOverview> topic the main body-level element is the
+                &lt;learningOverviewbody>. This element can contain the following elements in this
+                order:</p>
+            <ol>
                     <li>&lt;lcIntro>: introduction to the overview</li>
                     <li>&lt;lcAudience>: facts about the students for whom the course is intended </li>
                     <li>&lt;lcDuration>: estimated time to complete the course</li>
-                    <li>&lt;lcPrereqs>: any requirements for students before they take the course</li>
+                    <li>&lt;lcPrereqs>: any requirements for students before they take the
+                        course</li>
                     <li>&lt;lcObjectives>: what students should gain from the course </li>
-                    <li>&lt;lcResources>: any resources used or extra information for the course</li>
-                </ol>
-                These elements may be followed by an unlimited number of &lt;section> elements.</p>
+                    <li>&lt;lcResources>: any resources used or extra information for the
+                        course</li>
+                </ol> 
+            <p>These elements may be followed by an unlimited number of &lt;section>
+                elements.</p>
             <p>Here is an example of a &lt;learningOverviewbody>:</p>
             <pre>&lt;learningOverviewbody><draft-comment author="kheath">pre from "../LearningDITA/en-us/Learning_and_training_specialization/samples/lo_feedingducks.dita"</draft-comment>
         &lt;lcAudience id="lcAudience_rth_l4r_rcb">This course is intended for current or future owners of small- to medium-sized flocks of domestic ducks.&lt;/lcAudience>

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
@@ -16,8 +16,9 @@
     </prolog>
     <learningContentbody>
         <lcInstruction id="lcInstruction_js5_cqb_yz">
-            <p>The &lt;learningSummary> topic type contains review materials. This allows you to review
-                the content and puts it in perspective with your learning objectives. This topic can also include instructions on what to do next.</p>
+            <p>The &lt;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.</p>
             <p>In a &lt;learningSummary> topic, the main body element is the &lt;learningSummarybody>. The &lt;learningSummarybody> element can contain the following elements:
                 <ol>
                     <li>&lt;lcSummary> summary of the learned goals</li>

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
@@ -45,8 +45,8 @@
    &lt;/learningGroup>
 &lt;/learningGroupMap></pre>
             <p>Within a learning group element you can embed other learning groups and learning
-                objects. This allows you to reuse topics, lessons, chapters, etc. You can also reuse
-                other learning map types by using the &lt;learningObjectMapRef> and
+                objects. This allows you to reuse topics, lessons, etc. You can also reuse other
+                learning map types by using the &lt;learningObjectMapRef> and
                 &lt;learningGroupMapRef></p>
         </lcInstruction>
     </learningContentbody>