[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]