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

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

 | 919-254-2879

From:      
 Kristen James Eberlein
<>

To:      
 John Hunt <>,
dita TC <>, ""
<>

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)