← Prev in month ← Prev in thread
Next in thread → Next in month →

lightweight learning sample topics

From
John Hunt <>
Date
2016-01-05T21:37:11+00:00
ID
Thread
lightweight learning sample topics
Hi lightweight DITA and learning content
enthusiasts -

Building on the discussion Amber Swope
led at our Dec 7 meeting and on Michael Priestley's strawman summary of
topic and map types, I put together a set of sample lightweight learning
and training topics for further review and discussion.

See these related posts -
Amber's working proposal - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201511/msg00018.html
Michael's strawman summary of the topic
types - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201512/msg00005.html

1) Lightweight Overview topic
- Includes optional specialized sections
for prereqs and objectives, plus one or more additional generic content
sections.

<overview id="overview_h2m_lg4_45">
 <title>My LW Overview</title>
 <shortdesc>Here's a working
sample of a LW DITA overview topic.</shortdesc>
 <overviewbody>
  <prereqs><title>Prerequisites</title>
    <p>Do we need a
prereq section and would it always come first?</p>
  </prereqs>
  <objectives>
   <objectivesStem>Here's
some objectives:</objectivesStem>
   <objectivesGroup id="objectivesGroup_llz_qg4_45">
    <objective>Content
of each objective is restricted to common inline</objective>
    <objective>Keep
it easy</objective>
    <objective>Keep
it light</objective>
   </objectivesGroup>
  </objectives>
  <section>
   <title>More sections</title>
   <p>And more sections
as needed for additional content.</p>
  </section>
 </overviewbody>
</overview>

2) Lightweight Summary topic
- Includes optional specialized objectives,
review, resources, and next steps sections, plus one or more additional
generic sections.

<summary id="summary_pvs_l34_45">
 <title>LW Summary</title>
 <shortdesc>Here's a working
sample of a LW DITA summary topic.</shortdesc>
 <summarybody>
  <objectives>
   <title>Objectives</title>
   <objectivesStem>You
now know this:</objectivesStem>
   <objectivesGroup id="objectivesGroup_vqd_r34_45">
    <objective>Keep
it simple</objective>
    <objective>Keep
it lightweight</objective>
   </objectivesGroup>
  </objectives>
  <review>
   <title>Review</title>
   <p>Provide your review
with all-blocks available for you to do it.</p>
  </review>
  <resources>
   <title>Resources</title>
   <p>And all blocks
available for describing resources.</p>
  </resources>
  <nextSteps>
   <title>Next Steps</title>
   <p>All blocks also
for next steps.</p>
  </nextSteps>
  <section>
   <title>More sections</title>
   <p>And of course
more sections as needed for other stuff  you might want to provide.</p>
  </section>
 </summarybody>
</summary>

3) Lightweight Assessment Topic
- This assessment topic includes embedded
topics for singleselect, multipleselect, and openquestion. 
- The assessment topic might have it's
own body content, if needed to introduce a set of questions or a test,
etc.
- Each question could be in a separate
file and included into the assessment with a conref.

<assessment id="assessment_ujn_2k4_45">
 <title>LW Assessment</title>
 <shortdesc>Here's some same
LW assessment items</shortdesc>
 <assessmentbody>
 </assessmentbody>
 <singleSelect id="singleSelect_hjp_hk4_45">
  <title>Optional title -
Unless the title becomes the question?</title>
  <shortdesc>If there's a
statement to make before the question, make it here.</shortdesc>
  <singleSelectBody>
  <question>The third planet
in our solar system is named:</question>
  <answerOptionGroup id="answerOptionGroup_ijp_hk4_45">
   <answerOption>
    <answerContent>Pluto</answerContent>
   </answerOption>
   <answerOption>
    <answerContent>Jupiter</answerContent>
   </answerOption>
   <answerOption>
    <answerContent>Earth</answerContent>
    <lcCorrectResponse/>
   </answerOption>
   <answerOption>
    <answerContent>Mars</answerContent>
   </answerOption>
  </answerOptionGroup>
  </singleSelectBody>
 </singleSelect>
 <multipleSelect id="multipleSelect_gf2_1l4_45">
  <title>Optional title -
Unless the title becomes the question?</title>
  <shortdesc>If there's a
statement to make before the question, make it here.</shortdesc>
  <multipleSelectBody>
  <question>Which of the
following is a planet? (Select all that apply.)</question>
  <answerOptionGroup id="answerOptionGroup_rbs_dl4_45">
   <answerOption>
    <answerContent>Pluto</answerContent>
   </answerOption>
   <answerOption>
    <answerContent>Jupiter</answerContent>
   </answerOption>
   <answerOption>
    <answerContent>Earth</answerContent>
    <lcCorrectResponse/>
   </answerOption>
   <answerOption>
    <answerContent>Mars</answerContent>
   </answerOption>
  </answerOptionGroup>
  </multipleSelectBody>
 <multipleSelect>
 <openQuestion id="openQuestion_vfl_gl4_45">
  <question>What are some
reasons why Pluto is not considered a planet?</question>
 </openQuestion>
</assessment>

John

___________________________________
John Hunt
Senior Technical Content Architect 
IBM Analytics, Enterprise Social Solutions
Research Triangle Park, Durham, NC 27703
← Prev in month ← Prev in thread
Next in thread → Next in month →