Updates checked in - Review #2 comments: Learning & training portion of the archSpec

[John Hunt/Cambridge/IBM <john_hunt@us.ibm.com>]

Hi Kris, Robert, and L&T Sc members
-

I've made updates to re-organize the
map for the learning and training interactions domain, in response to DITA
1.3 introducing the new set of learning2 domain elements.

1) Updated the learningTraining-elements.ditamap
to re-organize the sections on the interactions domain.
  - Learning2 elements grouped
into "Learning2 interactions domain elements (DITA 1.3)"
  - Learning1 elements grouped
into "Learning1 interactions domain elements (DITA 1.2)"
  - Common learning2 elements in
"Common learning2 interactions domain elements (DITA 1.3)"
  - Common learning1 elements in
"Common learning1 interactions domain elements (DITA 1.2)"

2) Updated these topic files
learningTraining-interactions-domain-elements.dita
learningTraining-common-interactions-elements.dita
learningTraining-learning2-domain.dita

3) Added these topic files (for new
map containers)
learningTraining2-common-interactions-elements.dita
learningTraining-learning1-domain.dita

4) Obsoleted this ditamap (references
now directly included in the learningTraining-elements.ditamap)
learning2-domain.ditamap

I've run a test build, and results look
okay to me. 

Until Robert puts up a new build, the
best place to look for these changes is the learningTraining-elements.ditamap
in this svn location - https://tools.oasis-open.org/version-control/svn/dita/spec/langRef/.


Have a look, and get back with any comments.

Thanks.

John

___________________________________
John Hunt
Chair, OASIS DITA Learning and Training
content sub-committee
Senior Technical Content Architect 
IBM Collaboration Solutions | User Experience: Design and Information Excellence
4502 S. Miami Blvd, Durham, NC 27703
john_hunt@us.ibm.com | 919-254-2879



From:      
 Kristen James Eberlein
<kris@eberleinconsulting.com>
To:      
 John Hunt <john_hunt@us.ibm.com>,
dita TC <dita@lists.oasis-open.org>, "dita-learningspec@lists.oasis-open.org"
<dita-learningspec@lists.oasis-open.org>
Date:      
 11/01/2014 09:56 AM
Subject:    
   Review #2 comments:
Learning & training portion of the archSpec

---

There are some review comments that Robert and I cannot
handle. They concern the organization of the learning & training portion
of the architectural spec, specifically the following sections:

• Learning2 domain: http://ditaweb.com/oasis-dita/#/00074601-DA$00074552-DB$Learning2 domain
  • Comment by John Hunt: "We need to present these so that they're organized around the 7 top-level question types, then the support elements. This alpha list is not very useful. See the org used for learning interaction base domain elements for the learning(1) domain. And then we list out separately the common interactions elements."
  • Response by Robert Anderson: "Kris and I don't know how to make this change - hoping you or somebody else on the TC can reorganize better, otherwise it will stay as is."
    
• Common topic elements: http://ditaweb.com/oasis-dita/#/00074601-DA$00073720-DB$Common topic elements
  • Comment by John Hunt: "General commeont on these Common topic elements - I don't see how anyone will know to what topic and in what structure they're intended to be used. This needs to be looked at closely."
  • Response by Robert Anderson: "Referring to TC for help - L&T subcommittee needs to provide input on how to reorganize, we're not sure how to improve. The current organization matches DITA 1.2 organization, except that the titles of each group have been very slightly tweaked."

John, we'll look to you and the
Learning & Training subcommittee to perform any rewriting or reorganization
for these sections. We'll bring it up at the TC meeting on 4 November 2014.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)