[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita-learningspec] RE: Whither learningPractice?
I was actually looking for the topicref, not necessarily a topic type, although I kind of expected the topic type. I think it makes sense to use task as a base. If memory serves now that I think about it, one of my arguments for relaxing the task model in 1.2 was to enable construction of exercises that were not formal lists of steps, but just a description of what to do. I think I would still want to specialize from task to make an exercise topic and be able to do things like name the substeps "exerciseSolution" or similar. Cheers, E. On 6/10/13 9:36 AM, "Myers, Mark" <mark.myers@sap.com> wrote: > 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 > -- 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/
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]