DITA Technical Committee Meeting Minutes - 24 November 2009

["Gershon Joseph (gerjosep)" <gerjosep@cisco.com>]

 

 

Gershon Joseph Technical Leader, Engineering Product Development Services gerjosep@cisco.com Phone: +972 9 892-7157 Mobile: +972 57 314-1170	Cisco Systems, Inc. Israel Cisco home page

Think before you print.

This e-mail may contain confidential and privileged material for the sole use of the intended recipient. Any review, use, distribution or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive for the recipient), please contact the sender by reply e-mail and delete all copies of this message.

Cisco Systems Limited (Company Number: 02558939), is registered in England and Wales with its registered office at 1 Callaghan Square, Cardiff, South Glamorgan CF10 5BT

 

DITA Technical Committee Meeting Minutes
========================================


The DITA Technical Committee met on 24 November 2009 at 08:00am PT for 60 
minutes.

Chaired by Don Day <dond@us.ibm.com>
Minutes recorded by Gershon Joseph <gerjosep@cisco.com>


Roll call

> Quorum was achieved.


Approve minutes from previous business meetings: 
* http://lists.oasis-open.org/archives/dita/200911/msg00141.html (17 November 2009, Joseph) 
* http://lists.oasis-open.org/archives/dita/200911/msg00145.html (18 November 2009, Nevin--corrections to review)

> Minutes approved as amended, by acclamation. (should be "key space determination")


Subcommittee/liaison reports (as needed)

* OASIS DITA Pharmaceutical Content Subcommittee

> Steffen: The SC has started its activities. We did a public webinar where we 
> introduced the objectives and details of the SC and the webinar was very well
> received. We had over 50 participants. We are still following up on contacts 
> from pharma companies who would like to join our work.

> We are taking some of the existing XML standards in use in the pharma industry
> and we are looking at pharma docs following one or more of these standards and
> mapping them to a DITA format. This gives members practical experience of 
> marking up in DITA. Also, we see how well these standards map into DITA. We 
> are 1) mapping into dita 1.1 using <data>, <foreign> etc. and 2) see what it 
> could look like with a pharma specialization in place (sort of heading towards
> a pharma domain spec plus spec topic types. 

> Another part of our work is developing sample XSLT to transform from the 
> existing pharma standards to DITA and back. 

> We are still working on getting more members enrolled, while we also work on 
> these practical exercises. We prefer working on a practical level rather than
> a theoretical level at this time. This is a learning experience while 
> providing a great starting point to develop our detailed work plan for the 
> SC.


Business:


ITEM: DITA 1.2 specification (revised by Joseph 24 November 2009) 
* Spreadsheet and DITA topics located in the Subversion repository 
* Information about contributors, deadlines, editorial guidelines, Subversion 
  clients, and more 
* Business: 

  a Progress report on spec review #2: All reviews completed!

  b Need to revise spec author/review schedule due to the following issues: 
    * Constraints proposals and issues 
    * Discussion around terminology 
    * Work being done to restructure conref/keyref/href material 
    * The following schedule was agreed upon last meeting. Presupposes that the
      DITA TC resolve all remaining open issues during the November 24 meeting.
      If that does not happen, the dates need to shift according to the delay. 
      Is this schedule still realistic at this time?

> Gershon asked if anyone has issues sticking to this date.

> Eliot is working with the L&T SC to finalize the DTD changes. This has not 
> been completed.

> All DTD and Schema changes must be in place by Dec 7, along with the full 
> spec docset.

> Robert: I'm waiting on task update and learning update. Everything else that's
> been decided Eric and I have included and posted in the most recent drop.
> Everyone confirmed their commitment to completing the DTDs, XSDs and docs by 
> 7 December.

  c Need for authors to handle the following points (we might need to schedule 
    an authors meeting) 
    * Implementing "referencing element" and "referenced element" terminology 
    * Implementing cascade vs. inherit terminology 
    * Moving content of some <draft-comment> elements -> XML comments; for the 
      next review, we should be using <draft-comment> elements only for 
      comments to reviewers. 
    * Ensuring conformance statements are valid, correct and correctly marked 
      up ("must", "should" etc. correctly used and tagged) 
    * Implementing changes needed to ensure prose complies with the new 
      terminology (DITA Document Type, etc.) 

  d Are all authors able to commit to the revised deadline?

> No-one on the call stated any concerns.


New ITEM: conref.dita editorial review 
* http://lists.oasis-open.org/archives/dita/200911/msg00138.html (Nevin) 

> Bruce has a number of questions, which are in comments in the topic as well as
> in the email referenced above.

> Q1
> ACTION: Paul to drive the research and discussions to answer Bruce's first 
> question over email.

> Q2 - What happens if none is provided? It can be resolved? The answer is in 
> the keyref spec. Michael is not sure whether keyref should be in the answer, 
> since it makes it sound like keyref behaves like topicref. 
> ACTION: Michael to email clarification text to the list so Bruce can 
> incorporate it into the topic.

> Q3
> ACTION: Kris to help Bruce with the linking issues.

> Q4 - Question to Eliot.
> Eliot has not had a chance to address. 
> ACTION: Eliot to respond via email with clarification for Bruce to 
> incorporate.

> CONTINUED (Revisit next week)


New ITEM: Vocabulary module (terminology question) 
* http://lists.oasis-open.org/archives/dita/200911/msg00139.html (Self) 
* Seems to be closed. Just need to verify this is a non-issue 

> CLOSED (non-issue)


ITEM: Element-by-element recommendations for translators 
* http://lists.oasis-open.org/archives/dita/200910/msg00065.html (Hackos) 

> JoAnn: Translation is part of the DITA spec – the spec needs to support 
> translation so vendors know what to do.

> Eliot: The definitions for translation are not normative. They are just 
> recommendations.

> DECISION: Keep this info in the spec, update it for DITA 1.2, and move it into
> an appendix of the lang ref.

> ACTION: Kris to change the maps used to build the doc packages accordingly.


Ongoing checks:


ITEM: Domain integrator 
* DITA DTD Generator 
* http://www.elovirta.com/dita-generator/ 
* http://lists.oasis-open.org/archives/dita/200907/msg00116.html (Robert's message with more info) 

> Robert forwarded Eliot's comments to the Jarno (the developer) and he said he
> will implement them.

> Eliot will need to update his current 1.1 specialization methodology and 
> tutorial for 1.2 and mention this tool as well.

> ACTION: Robert to forward Jarno's contact details to JoAnn.


*** Meeting Adjourned ***