OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-learningspec message

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


Subject: RE: Whither learningPractice?


Hi Eliot,

I can't speak about the learningPractice, that discussion predates my involvement with the SC. 

I can offer a recommendation though based on SAP's approach. We also need to create exercises and solutions in our training content. We use the task element. We specialized it as "Exercise" but otherwise it is just like task.

We have authors write the tasks using the steps element to contain general instructions and the substeps element to contain the detailed step-by-step actions a user would take to complete the general instructions. 

So for example, general instruction go here:

/learningContent/task/taskbody/steps/step

The detailed action a user needs to do to complete that instruction go beneath the step in a substeps element like this:

/learningContent/task/taskbody/steps/step/substeps/substep

When we publish our handbooks, we publish each task twice: first labeled as an "exercise" which includes the steps and omits the substeps, the again labeled as a "solution" which include both the steps and substeps.

I attached a screen shot from our instructor handbook as an example. 

We also follow this approach for learning assessments, we publish once with no answers indicated and then again with the answers indicated. 

If you want to see the sources or other examples just let me know.  

Cheers,
Mark


Mark Myers
Knowledge Transfer Architect, Production Platform Management and Operations
Knowledge Productization Services
SAP America, Inc.
3999 West Chester Pike
Newtown Square, PA 19073 USA
T 1-610-661-5823
F 1-610-661-5824
M 1-484-802-1809 







-----Original Message-----
From: dita-learningspec@lists.oasis-open.org [mailto:dita-learningspec@lists.oasis-open.org] On Behalf Of Eliot Kimber
Sent: Sunday, June 09, 2013 3:18 PM
To: dita-learningspec@lists.oasis-open.org
Subject: [dita-learningspec] Whither learningPractice?

I notice that John Hunt and Robert Bernard's 2005 paper
http://www.ibm.com/developerworks/xml/library/x-dita9a/ includes a
"learningPractice" topic type (or, more generally, major section of a
course, parallel with learningOverview, learningSummary, etc.)

However, we don't have a learningPractice topic type or map type in the 1.2
L&T specialization.

Was that a deliberate decision or does the 2005 paper reflect later thinking
after the 1.2 L&T design was finalized?

I'm looking for how to organize "exercises" for an instructor-led course and
learningPractice is just the thing.

Of course, I can create my own specializations but I was curious as to why
there's no obvious accommodation for exercises in the 1.2 L&T design.

Cheers,

E. 

-- 
Eliot Kimber
Senior Solutions Architect, RSI Content Solutions
"Bringing Strategy, Content, and Technology Together"
Main: 512.554.9368
www.rsicms.com
www.rsuitecms.com
Book: DITA For Practitioners, from XML Press,
http://xmlpress.net/publications/dita/practitioners-1/


---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that 
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 

Attachment: exercise.PNG
Description: exercise.PNG



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