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