Groups - DITA TC Meeting Minutes 21 October 2014 uploaded

Submitter's message

        =================================================

Minutes of the OASIS DITA TC

Tuesday, 21 October 2014

Recorded by Nancy Harrison

link to agenda for this meeting:	

https://wiki.oasis-open.org/dita/PreviousAgendas

Regrets:  Joann Hackos

Standing Business

=================

Approve minutes from previous business meetings:

[none available this week]

Subcommittee Reports

	none

Announcements

	none

Business

========

1. DITA 1.3 progress    

    Second spec review (Eberlein & Anderson)

    Transformation utilities and DITA 1.3 grammar files (Kimber) 

[see individual items below]

2. Action items

   - Action items from 19 August 2014

        Robert: Shells for L & T: Robert, Kris, Eliot, and John to meet. 

Robert; group had conclusive discussion; TC will deliver one set of shells for each variety of L&T shells, but Eliot will maintain RNG version that allows for generation of either one or combination. [removing this item from list of ActionItems]

   - Action items from 26 August 2014:

        Nancy will review specialization and constraints topics, with the purpose of: a) suggesting placement for new topic or content chunk, b) reviewing for clarity, organization, technical accuracy. This is in regard to content re limitations of XSD shells and constraints. (currently in process, now that spec is available for review) 

[no change]

   - Action items from 2 September:

        Stan to assess Front Page wiki for possible clean-up 

[no change]

   - Action items from 16 September:

        Robert will send details about necessary OASIS comments in grammar files to Eliot. 

[no change]

3. 2nd spec review progress: 13 - 27 October 2014

   - https://wiki.oasis-open.org/dita/1.3-spec-review-#preview

     Wiki page contains:

        Download link for official review draft

        Review objectives

        Tracking tables for review assignments

        Information about prizes (yet to be determined) 

    Review stats as of 10:20 AM ET:

   - https://lists.oasis-open.org/archives/dita/201410/msg00133.html 

     Proposal owners' review

        Table of proposal owner reviews 

[skip this item until Stan and Michael are on call]

4. Trello items: Spec clarification and improvements

    https://wiki.oasis-open.org/dita/1.3-spec-review-#trello-spec-clarifications 

ActionItems: 

   a. wrt constraints file name extensions, Nancy will contact Eliot by mail, with Kris in loop, to clarify extension issue.

   b. TC members will work on Trello items and make changes in spec and in table on wiki

5. Continued item: Question about domains attribute:

    Resolution reached

    https://lists.oasis-open.org/archives/dita/201410/msg00103.html (Eberlein, 15 October 2014)

    https://lists.oasis-open.org/archives/dita/201410/msg00000.html (Anderson, 3 October 2014)

This was discussed via email between Robert Anderson and Eliot Kimber; 

Resolution:  the spec will be updated to allow use of tokens even when using base DITA shells,  but it won't include any normative language in this area, so the tokens won't be required.

6. New item: Issues in DTDs checked into SVN

    https://lists.oasis-open.org/archives/dita/201410/msg00110.html (Anderson, 20 October 2014)

    https://lists.oasis-open.org/archives/dita/201410/msg00111.html (Kimber, 20 October 2014)

    https://lists.oasis-open.org/archives/dita/201410/msg00112.html (Anderson, 20 October 2014)

    https://lists.oasis-open.org/archives/dita/201410/msg00113.html (Eberlein, 20 October 2014)

    https://lists.oasis-open.org/archives/dita/201410/msg00115.html (Anderson, 20 October 2014)

    https://lists.oasis-open.org/archives/dita/201410/msg00116.html (Kimber, 20 October 2014) 

Robert gave overview; issue arose when Kris noticed a problem in domain tokens; Eliot said it was a problem in 1.2, but it wasn't.  That is, 1.2 as distributed by OASIS didn't have problem; 1.2 in SVN, which was generated by Eliot's RNG->DTD scripts, has it.  So Robert resurrected tools he built and used for 1.2, and did a diff between what was shipped in 1.2 and the 1.2 files generated by Eliot's tools.  This turned up a whole bunch of differences, so areas where the transform was generating invalid code, because there were typos in the RNG, some more anomalous diffs.

[long discussion, mostly between Robert, Kris, and Eliot, with some comments by others, as to whether we need a serious manual inspection of the 1.2 / 1.3 code, and whether we need to stop generating the DTDs from the transforms at some point and finish them off by hand for 1.3. Robert and Kris think we need to do this, Eliot would like to create final 1.3 code using the transform.]

 

Will continue discussion next week to try to come up with a date to go over to manual mode; ChrisN, DavidH, BobT have said they'll do testing of doc shells against real content. Eric Sirois agreed to do visual inspection of XSD files.  Feature owners really need to test 'final' spec and content models to make sure the descriptions and grammar files for their features all read and work as expected.

Don suggested that Eliot incorporate a regex test of his generated files as part of validating them.  Eliot said he would do that.  Not an alternative to manual inspection, but in addition...

7. Statements of use for DITA 1.3

    https://lists.oasis-open.org/archives/dita/201410/msg00114.html (Eberlein, 20 October 2014)

Kris; please take a look at emailed reference item for next week.

8. "Fun" with constraints:

    https://lists.oasis-open.org/archives/dita/201410/msg00125.html (Eberlein, 20 October 2014) 

Kris; we really need folks to look over this material; Nancy, Bob, TomM will all review it.

9. Use of %tbl.table.name in tblDecl.mod

    https://lists.oasis-open.org/archives/dita/201410/msg00118.html (Kimber 20 October 2014)

Overview: there continues to be an exchange by Robert and Eliot on list 

closed at 11:59 Eastern
        

-- Nancy Harrison
        
    

    
        Document Name: DITA TC Meeting Minutes 21 October 2014

        
        No description provided.        

        Download Latest Revision

        Public Download Link
        
        Submitter: Nancy Harrison

                Group: OASIS Darwin Information Typing Architecture (DITA) TC

        Folder: Meeting Notes

        Date submitted: 2014-10-27 20:08:13