OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-lightweight-dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: 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
john_hunt@us.ibm.com



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]