dita-lightweight-dita message
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]
Subject: lightweight learning sample topics
- From: "John Hunt" <john_hunt@us.ibm.com>
- To: dita-lightweight-dita@lists.oasis-open.org
- Date: Tue, 5 Jan 2016 16:36:56 -0500
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]