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: Re: [dita-lightweight-dita] LwDITA Specialization model and learning content


Dear John and all,

I updated your <objectivesStem> to a <p> instead of a <ph> (needs to be a block element), and wrapped your objectives in <p> (remember list items in XDITA need paragraphs).
Then I worked some of Tim's tool magic and the attached shows the resulting topic and RNG file... looking good.

Best,

Carlos


-- 
Carlos Evia, Ph.D.
Director of Professional and Technical Writing
Associate Professor of Technical Communication
Department of English
Center for Human-Computer Interaction
Virginia Tech
Blacksburg, VA 24061-0112
(540)200-8201


On Fri, Mar 17, 2017 at 3:20 PM, John Hunt <john_hunt@us.ibm.com> wrote:
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

Attachment: overview.rng
Description: Binary data

<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="overview.rng" schematypens="http://relaxng.org/ns/structure/1.0";?>
<overview id="someID">
    <title></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><p>Content of each objective is restricted to common inline</p></objective>
                <objective><p>Keep it easy</p></objective>
                <objective><p>Keep it light</p></objective>
            </objectivesGroup>
        </objectives>
        <section>
            <title>More sections</title>
            <p>And more sections as needed for additional content.</p>
        </section>
    </overviewbody>
    
    
</overview>


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
https://lists.oasis-open.org/archives/dita-lightweight-dita/201703/msg00018.html
lists.oasis-open.org
crawl=CC-MAIN-2020-50
11891
application/http; msgtype=response
sha1:RHOZ5DOD7VAJXAZWLAN2LWYLFT7ZYOVJ
<urn:uuid:8be208bb-0c58-4107-ab1a-ffb90ab6b66b>
2020-11-27T07:03:15Z
34.233.166.49
text/html
sha1:FJXU3EFBOWY7X6JA6VSY6AQRUDXUGU4V
<urn:uuid:8898696d-26cd-4a36-8afa-7cbe85e93729>
https://lists.oasis-open.org/archives/dita-lightweight-dita/201703/msg00018.html
response
<urn:uuid:d535f8e5-6672-43ee-83a0-71fb56729e66>
isPartOf: CC-MAIN-2020-50
publisher: Common Crawl
description: Wide crawl of the web for November/December 2020
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-64.ec2.internal
software: Apache Nutch 1.17 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.2-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: http://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/