Lightweight DITA SC

 View Only

RE: [dita-lightweight-dita] Strawman structures for learning/training doctypes

  • 1.  RE: [dita-lightweight-dita] Strawman structures for learning/training doctypes

    Posted 04-18-2016 13:53
    Hi Birgit and LW DITA enthusiasts - Getting back to this exchange on the
    LW DITA structures for educational content - sounds like we have general
    support for the initial proposal. Three learning topic types - overview,
    summary, assessment. Assessment items as topics, with three
    assessment topics - singleSelect, multipleSelect, and openQuestion. A learning map - with learning-specific
    metadata. Questions at this point - Are we generally good with this as the
    base level of LW support needed for learning, training, and educational
    content? Has anyone developed or plan to develop
    schemas, based on the LW base? If not, who can we enlist in this effort? How will we treat these in relation
    to the core LW DITA structures? See these related posts - Amber's working proposal - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201511/msg00018.html Michael's strawman summary of the topic
    types - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201512/msg00005.html John's summary and sample topics - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201601/msg00000.html Birgit has also proposed some additional
    assessment types, as extensions to DITA 1.3. Is is correct to assume that
    we do not plan to add or support these with LW DITA? Thanks. John ___________________________________ John Hunt Member of OASIS Lightweight DITA sub-committee Senior Technical Content Architect IBM Collaboration Solutions From:      
      "Birgit Strackenbrock"
    <birgit@xstructuring.eu> To:      
      "'Eliot Kimber'"
    <ekimber@contrext.com>, John Hunt/Cambridge/IBM@Lotus Cc:      
      "'Amber Swope'"
    <amber@ditastrategies.com>, "'Carlos Evia Puerto'" <cevia@vt.edu>,
    "'Jan Benedictus'" <jan.benedictus@liones.nl>, "'Michael
    Priestley'" <mpriestl@ca.ibm.com> Date:      
      03/09/2016 05:36 AM Subject:    
        RE: [dita-lightweight-dita]
    Strawman structures for learning/training doctypes Dear Eliot, So you prefer different question type topics
    and not one question-topic with different interactions inside. Is this
    what you mean? Anyway, in both approaches you can use
    a map to collect questions. Maybe it’s a little bit more easy for humans
    and applications to have different question type topics and not have to
    look inside the question to see which type it is. Regards, Birgit   Van: Eliot Kimber [ mailto:ekimber@contrext.com ]
    Verzonden: woensdag 9 maart 2016 10:14 Aan: Birgit Strackenbrock <birgit@xstructuring.eu>; 'John Hunt'
    <john_hunt@us.ibm.com> CC: 'Amber Swope' <amber@ditastrategies.com>; 'Carlos Evia Puerto'
    <cevia@vt.edu>; 'Jan Benedictus' <jan.benedictus@liones.nl>;
    'Michael Priestley' <mpriestl@ca.ibm.com> Onderwerp: Re: [dita-lightweight-dita] Strawman structures for learning/training
    doctypes   I have defined a single-question topic
    type for use where the client wants to manage tests at the map level, that
    is, organize individual questions using a map rather than conref from within
    a topic.   In my formulation the special processing
    is to suppress the topic title on output so that the presentation result
    is simply a sequence of questions. This is in the context of test documents.   Having this type of single-question topic
    is also useful for managing pools of questions in systems that need to
    have reliable titles associated with managed objects and that prefer (or
    require) managing content at the topic level (e.g., for search and retrieval
    within the CCMS interface).   Without an architectural change to DITA
    whereby maps can define hierarchies of elements  below the topic level
    there's really no better way to manage individual questions.   Cheers,   E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com   From: Birgit Strackenbrock < birgit@xstructuring.eu > Date: Wednesday, March 9, 2016 at 5:57 PM To: John Hunt/Cambridge/IBM < john_hunt@us.ibm.com > Cc: 'Amber Swope' < amber@ditastrategies.com >,
    'Carlos Evia Puerto' < cevia@vt.edu >,
    'Jan Benedictus' < jan.benedictus@liones.nl >,
    'Michael Priestley' < mpriestl@ca.ibm.com >,
    Eliot Kimber < ekimber@contrext.com > Subject: RE: [dita-lightweight-dita] Strawman structures for learning/training
    doctypes   Dear John and other T&L experts,   That can be an approach but disadvantage
    of making the interaction-types topics is that you are not compatible with
    DITA 1.2/1.3 anymore. If that is acceptable, no problem with me.   Otherwise, maybe we could do something
    in-between: define a topic question and in the questionBody the user can
    choose only one interaction out of the group (multipleSelect singleSelect
    openQuestion). The content model of e.g. multipleSelect can bet be same
    as the one of multipleSelectBody in the example   https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201601/msg00000.html . This could look like this: I think the advantage will be that we more
    easily can define more/other interactions and add them as an domain. So, would do you think about this?   Anyway, it’s somehow funny, for a customer
    we (I work together with Jan’s team) have chosen for the approach with
    nested topics for questions.   Kind regards, Birgit   Van: John Hunt [ mailto:john_hunt@us.ibm.com ]
    Verzonden: maandag 7 maart 2016 17:12 Aan: Birgit Strackenbrock < birgit@xstructuring.eu > CC: 'Amber Swope' < amber@ditastrategies.com >;
    'Carlos Evia Puerto' < cevia@vt.edu >;
    'Jan Benedictus' < jan.benedictus@liones.nl >;
    'Michael Priestley' < mpriestl@ca.ibm.com > Onderwerp: RE: [dita-lightweight-dita] Strawman structures for learning/training
    doctypes   Hi Birgit, We had some discussion at one of the LW DITA calls, and the working suggestion
    that came out of that was to treat the assessment items as topic specializations,
    and then let them become embedded sub-topics. and we thought we'd start with the three question types as single-select,
    multi-select, and open-question. that sample attempts to capture that approach I'm not aware of other efforts to make a scheme for these L&T topics,
    so will be very interested to see your results. Thanks. John ___________________________________ John Hunt Senior Technical Content Architect IBM Collaboration Solutions IBM Design Studios, Durham, NC 27703 john_hunt@us.ibm.com From:         "Birgit
    Strackenbrock" < birgit@xstructuring.eu > To:         John Hunt/Cambridge/IBM@Lotus,
    "'Michael Priestley'" < mpriestl@ca.ibm.com > Cc:         "'Amber
    Swope'" < amber@ditastrategies.com >,
    "'Carlos Evia Puerto'" < cevia@vt.edu >,
    "'Jan Benedictus'" < jan.benedictus@liones.nl > Date:         03/04/2016
    07:39 AM Subject:         RE:
    [dita-lightweight-dita] Strawman structures for learning/training doctypes Hi John and Amber, If you don’t mind I can made a XML schema for the LW
    topic markup for the three learning and training topic types of at least
    for the assessment, that the one I would like to start with. Anyway, I have a question about the assessment as shown in https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201601/msg00000.html . The three question types are standing after the assessmentbody. Is this
    really what it should be or should they stand within the assessmentbody?
    I would expect them inside. Please let me know if meanwhile someone else have developed schema’s and
    if so where I can find them or if it is ok that I do it. Kind regards, Birgit Van: John Hunt [ mailto:john_hunt@us.ibm.com ]
    Verzonden: maandag 8 februari 2016 16:25 Aan: Michael Priestley < mpriestl@ca.ibm.com > CC: Birgit Strackenbrock < birgit@xstructuring.eu >;
    Amber Swope < amber@ditastrategies.com >;
    Carlos Evia Puerto < cevia@vt.edu > Onderwerp: RE: [dita-lightweight-dita] Strawman structures for learning/training
    doctypes Hi Birgit - Based on discussion at the Dec 7 and the outline proposal from Amber Swope,
    I posted some sample LW topic markup for the three learning and training
    topic types we discussed. Look here - https://www.oasis-open.org/apps/org/workgroup/dita-lightweight-dita/email/archives/201601/msg00000.html I have not yet done anything to add these to a schema. Have a look and see what you think. Glad to discuss more, either at the
    next LW DITA call or separately. John ___________________________________ John Hunt Senior Technical Content Architect IBM Analytics, Enterprise Social Solutions 4502 S. Miami Blvd, Durham, NC 27703 john_hunt@us.ibm.com From:         Michael
    Priestley/Toronto/IBM To:         "Birgit
    Strackenbrock" < birgit@xstructuring.eu > Cc:         John Hunt/Cambridge/IBM@Lotus Date:         02/05/2016
    02:04 PM Subject:         RE:
    [dita-lightweight-dita] Strawman structures for learning/training doctypes Hi Birgit, I'm going to bring in John Hunt - he should be able to point you to his
    latest prototypes. Michael Priestley, Senior Technical Staff Member (STSM) Enterprise Content Technology Strategist mpriestl@ca.ibm.com http://dita.xml.org/blog/michael-priestley From:         "Birgit
    Strackenbrock" < birgit@xstructuring.eu > To:         Michael
    Priestley/Toronto/IBM@IBMCA Date:         02/05/2016
    04:49 AM Subject:         RE:
    [dita-lightweight-dita] Strawman structures for learning/training doctypes Hello Michael, Is this the most recent set? https://tools.oasis-open.org/version-control/svn/dita/subcommittees/LightweightDITA/branches/0.1/org.oasis.lwdita/dtd/ Or do the DTD’s standing in a github repository somewhere? Kind regards, Birgit Van: Birgit Strackenbrock [ mailto:birgit@xstructuring.eu ]
    Verzonden: woensdag 3 februari 2016 10:49 Aan: 'Michael Priestley' < mpriestl@ca.ibm.com > Onderwerp: RE: [dita-lightweight-dita] Strawman structures for learning/training
    doctypes Hello Michael, Are the specialization for LW T&L are already worked out in the DTD’s
    (or schema’s)? If so, where can I find them? Kind regards, Birgit Van: dita-lightweight-dita@lists.oasis-open.org [ mailto:dita-lightweight-dita@lists.oasis-open.org ]
    Namens Michael Priestley Verzonden: dinsdag 15 december 2015 23:00 Aan: dita-lightweight-dita@lists.oasis-open.org Onderwerp: [dita-lightweight-dita] Strawman structures for learning/training
    doctypes Here's what I have from my notes on today's discussion  - leaving
    tag names out of it overview - topic type, specialized from topic, containing specialized sections summary - topic type, specialized from topic, containing specialized sections
    (some may be reused from overview) assessment - topic type, specialized from topic, containing/grouping the
    following specialized topics:      single-select - specialized from topic with specialized
    sections for the question content, answer options, and feedback      multi-select - same as single-select but with different
    semantics      open-question - specialized from topic etc. learning map - specialized map type, with specialized metadata for duration,
    audience, etc. - and potentially some default structure/sequence - eg start
    with overview, finish with summary Net: 6 topic types expressed in 3 document types, 1 map type expressed
    in 1 document type Michael Priestley, Senior Technical Staff Member (STSM) Enterprise Content Technology Strategist mpriestl@ca.ibm.com http://dita.xml.org/blog/michael-priestley