Re: [dita-learningspec] feedback on review items

[john_hunt@us.ibm.com]

Thanks, John.

I've made revisions in response to your
comments.

See the latest zip posting -

http://www.oasis-open.org/apps/org/workgroup/dita-learningspec/download.php/25496/draft1_dita_learning_spec.zip

John Hunt

From:	John Accardi <John.Accardi@Sun.COM>
To:	"'John Hunt'" <john_hunt@us.ibm.com>
Cc:	dita-learningspec@lists.oasis-open.org
Date:	10/01/2007 10:13 PM
Subject:	[dita-learningspec] feedback on review items

---

John and Subcommittee:

1) I have taken a closer look at Scott's LOM metadata work at:

     http://wiki.oasis-open.org/dita/IMSLOMdesign

     and see that it is very complete.  Nothing has jumped
out at me 
that needs attention.  Thanks, Scott.

2) I have reviewed the topic spec indexed at:  
demo/learningsc/outot/index_topic_elements.html and have the following
comments/suggestions/observations:

  a) demo/learningsc/outot/index_topic_elements.html and 
demo/learningsc/outot/learningOverview.html:

     word "as" missing as in:

     learningOverview topic type
**
A Learning Overview topic identifies the learning objectives, includes
other information helpful to the learner, such *<as>* prerequisites,
duration, intended audience, and can include information and strategies
that seeks to gain attention and stimulate recall of prior learning.

  b) demo/learningsc/outot/learningSummary.html:

    one word to add that I think would clarity (achievement or
accomplishment) as in:

learningSummary topic type

A Learning Summary recaps and provides context for the *<achievement
of>* or *<accomplishment of>* learning objectives, provides guidance
to 
reinforce learning and long-term memory, and may pose questions to 
enhance encoding and verification of the learning content.

  c) demo/learningsc/outot/learningAssessment.html:

    suggested rewording:

learningAssessment topic type

A Learning Assessment presents instruments *<questions or interactions
instead of instruments>* that measure progress, encourage retrieval
*<recollection instead of retrieval>*, and stimulate reinforcement
of 
the learning content, and can be presented before the content as a 
pre-assessment or as a post-assessment test. The interactions use a 
sub-set of the Question-Test Interoperability (QTI) specification, 
implemented as a DITA domain specialization.

   d) demo/learningsc/outot/lcAsset.html:

        has a blank Example section

   e) Consistency issue:

       demo/learningsc/outot/langspec-dita/langref/shortdesc.html,
       demo/learningsc/outot/langspec-dita/langref/related-links.html,
       demo/learningsc/outot/learningContentbody.html,
       demo/learningsc/outot/learningSummarybody.html,
       demo/learningsc/outot/langspec-dita/langref/related-links.html:

        are a few of the pages linked to from the syntax
links on the 
topic pages that do not have an example block.

   f) demo/learningsc/outot/learningBasebody.html:

        this page has a link with link text "lcAuthorInfo"
in the 
Contains section that has no target page.