Minutes - 20Aug2009 meeting of OASIS DITA TC Spec authoring team

[john_hunt@us.ibm.com]

Here are my minutes of today's meeting.
If I missed your name on the attendee list or you notice other mistakes
that need correction, please let me know.  

John Hunt, IBM


=======================================================================================
Minutes - 20Aug2009 meeting of OASIS
DITA TC authoring team 
Chaired by Kristen James Eberlein 

Attendees:  Robert D Anderson, JoAnn Hackos, Eliot Kimber, Gershon
Joseph, Seth Park, Erik Hennum, John Hunt, David Helfinstine,
Robin Sloan, Rob Hanna, Bob Beims 

1)    Discussion about tracking work completed based on first
review 
        Use @rev=1.2.1 to mark changes in DITA files
based on comments in review #1 (previous decision)
        It's important to track the reviewer name and
dates on the review comments. 
        Then respond on the wiki page to indicate how
you have worked in the comments        .
        Agree about best practice for indicating on
the Wiki pages how we have dealt with reviewers' comments, with a good
example here - http://wiki.oasis-open.org/dita/ditaMaps)
        
2)     Status of work from the first review 
i        KE has work to do on the introductory topic,
but sees no issues in completing it. 

ii        Intro to DITA section - JoAnn and Eliot  
      
                This section needs
work and clarification about purpose of 
                this section.
                Need to crisp up
vocabulary we use for key terms, 
                especially related
to specialization. 

                Eliot targets getting
contributions for the intro section complete by Sep 1.
                JoAnn to complete
her contributions by Sep 15. 

iii        DITA map section        
                KE - This will
be ready for Review 2 

iv        Metadata - Gershon        
                Working on these.
Target date Sep 1.

v        DITA processing - Seth      
  
                Plans to work on
this over the weekend. Will provide an assessment of
scope of work by 8/24.

vi        Translation - Joann and Robert    
    
                Joann to get to
this after trip to Japan, and complete by Sep 15. 

v        Specialization - Eliot      
  
                Comments handled
from first review 
                Some issues remain,
but he can complete them. 

vi        Learning and Training - John and Eliot
                John has provided
a map and architectural spec topics. 
                Recent updates
approved by TC require updates to the doc topics plus DTD and XSD schemas.
                Eliot to make updates
needed for both the schemas and doc for these changes by Sep 1.

vii        Technical content spec      
  
                A gap here
                Some 1.1 topics
can get moved here 
                JoAnn is lead for
this part of the spec and
can get this ready by mid-September 

                A question about
where to include the information about 
                ditabase - not
resolved at the meeting. 
                Discussion about
what to put into the base, and whether concept-task-reference should be
in the base. 

3) Schedule 
We discussed review dates and agreed on a schedule.

2nd TC Review goes out on Sep 21, 2009. 
2nd TC Review completes Oct 4, 2009. (Hard date - no review comments accepted
after this date) 

3rd TC Review goes out Oct 19, 2009 and completes Nov 1, 2009.

Target start of full OASIS Review for Nov 16, but no later than Dec 1

4) Examples in the arch spec topics 

What belongs in the arch spec topics
and what belongs in the lang ref topics? 
Do we conref? Use xrefs? Use links generated from relationship tables?

Input from Eliot that we need to avoid having the same information appear
twice in the published standard. Need to reconcile this with need for examples
to appear with each element but not wanting to repeat the same example
across elements in the group. Kris
Eberlein and Robert Anderson will talk offline about this.

Minutes submitted by John Hunt 
=======================================================================================

___________________________________
John Hunt
Structured Content Architect / Lotus Information Development Center
IBM Software Group/Lotus Software