Next in thread → Next in month →

Re: [dita-lightweight-dita] LwDITA Meeting Minutes for 29 May 2017

From
Kristen James Eberlein <>
Date
2017-05-30T01:37:07+00:00
ID
Thread
Re: [dita-lightweight-dita] LwDITA Meeting Minutes for 29 May 2017
Just a clarification on the committee note -- It is serving two
      (overloaded) purposes:

    
      
Acting as an equivalent of a stage two proposal. A DITA TC
        stage 2 proposal usually contains all the design details. See
        https://wiki.oasis-open.org/dita/DITA_2.0_Proposal_Process_DRAFT
        for an explication of the DITA TC process.

      

      
A document that the TC will actually (if approved) publish as
        a committee note.

    
    
I will suggest that the TC consider these two purposes
      sequentially.

    

    
Best,

      Kris

      

      Kristen James Eberlein

      Chair, OASIS DITA Technical Committee

      Principal consultant, Eberlein Consulting

      www.eberleinconsulting.com

      +1 919 682-2290; kriseberlein (skype)

      

    

    
On 5/29/2017 9:23 PM, Alan Houser
      wrote:

    

    Colleagues -
      

      

      Minutes from today's LwDITA subcommittee meeting are below. The
      minutes include announcements of several short-term items:
      

      - Availability of LwDITA committee note v15 and request to review
      

      - Special LwDITA SC meeting Friday, June 2, 11-12 EDT
      

      - Intention to present committee note to DITA TC for
      review/approval on June 5
      

      

      -Alan
      

      

      -----
      

      

      LwDITA Meeting Minutes for 29 May 2017
      

      

      1 PM ET Called to Order
      

      

      Attendees:
      

      Kris Eberlein
      

      Carlos Evia
      

      Alan Houser
      

      Mark Giffin
      

      Ullakaisa Kalander
      

      Michael Priestley
      

      Keith Schengili-Roberts
      

      

      ==Approval of Minutes==
      

      Deferred; distribution of 15 May minutes delayed by OASIS IT
      issues.
      

      

      ==Announcements==
      

      Proposed timeline for LwDITA summer work
(https://lists.oasis-open.org/archives/dita-lightweight-dita/201705/msg00020.html)

      

      Discussion:
      

      Kris Eberlein: Proposed plan and timeline to roll out LwDITA
      committee note to DITA Technical Committee.
      

      Goal: Committee note finalized, written for DITA-savvy audience,
      appropriate for public review.
      

      

      Recommendation:  Submit to DITA TC for review/approval June 5.
      After TC approval, open for 30-day public review.
      

      

      Alan Houser: Is review public or OASIS-member?
      

      Kris: Public
      

      

      Kris: Committee cannot work on committee note during public
      review. This would be a good time to develop sample files. Final
      work product should include sample files.
      

      

      Timeline: After 30-day public review, LwDITA subcommittee
      considers public review comments. Generates final committee note,
      submits to TC for approval.
      

      

      Decision: Timeline/approach accepted by consensus.
      

      

      ==Status/Updates to Committee Note==
      

      1. Carlos: V15 is available. Much improved. Distributed to LwDITA
      SC list (delayed by apparent OASIS IT issues)
      

      

      2. How to define a key reference in XDITA
(https://lists.oasis-open.org/archives/dita-lightweight-dita/201705/msg00021.html)

      

      Discussion centered around DITA 1.3 rules for resolving key
      references:
      

http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/processing-keyref-for-text.html#processing_key_references
      

      

      Decision by consensus:
      

      XDITA
      

      Add <keydef> element w/processing role defaulted or fixed
      value
      

      Add <linktext> to <topicmeta>, because needed for
      variable text per specification.
      

      Attributes:
      

      @keys
      

      @href
      

      @processing role - defaulted or set.
      

      

      Alan Houser will update LwDITA DTD, working with Carlos Evia and
      Mark Giffin.
      

      

      2. Footnotes (<fn>)
      

      

      Previous SC decisions:
      

      

      Footnote is a block element.
      

      Footnote cannot cannot contain mixed content.
      

      

      Decision by consensus:
      

      XDITA: <fn> contains paragraphs and lists (ol, ul, dl),
      data. <dl> is _not_ supported.
      

      

      HDITA: Footnote represented by <div> that contains
      paragraphs and lists.
      

      

      MDITA: Extended profile will use HDITA syntax.
      

      

      3. Proposal for mapping <note> to HDITA as a <div>
      

https://lists.oasis-open.org/archives/dita-lightweight-dita/201705/msg00009.html
      

      

      Carlos Evia:
      

      Issue: <note> cannot be mapped to <p>, because
      <note> contains paragraphs.
      

      Proposed Solution: Express <note> in HDITA as:  <div
      data-hd-class="note">
      

      

      Solution accepted by consensus.
      

      

      4. "Ghost elements in LwDITA DTDs
      

      Several elements are declared but not referenced. Examples: param,
      specmeta, specatt.
      

      Subcommittee decision: Remove from LwDITA DTD
      

      

      ==Next Steps==
      

      

      Request from Kris Eberlein: Request that subcommittee members
      review the latest committee note (v15) as a white paper. Send
      comments to the list.
      

      

      Kris will schedule special LwDITA SC meeting Friday, June 2, 11-12
      EDT for final review of committee note comments and go/no-go
      decision to send committee note to DITA TC for approval.
      

      

      Adjourned at 2:18 EDT
      

      

      

      

---------------------------------------------------------------------
      

      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
Next in thread → Next in month →