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: LwDITA Specialization model and learning content


Dear LW DITA SC -

I've taken a fresh look at the set of LW DITA sample topics for learning, which came out some discussions we had back in 2015. See - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201601/msg00000.html.

And I've now also taken a new look at the section on LwDITA Specialization model in the draft spec. 

I think the specialization model holds up very well for use with the sample learning topics. Below is my take on the Overview topic. I would think that applying the template to the sample summary and assessment topics would be equally straightforward.

1) XDITA topic for a learning overview

<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) XDITA specialization template for a learning overview

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

I have not tried anything further, but it looks to me that what's available in the proposed LwDITA provides sufficient support for representing basic learning content, including simple assessments.

Interested in what others think.

Thanks.

John Hunt
Senior Technical Content Architect 
IBM Collaboration Solutions | User Experience: Design and Information Excellence


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