[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: MEETING MINUTES -- 24 AUG 2004 -- DITA TECHNICAL COMMITTEE
MEETING MINUTES -- 24 AUG 2004 -- DITA TECHNICAL COMMITTEE *** Please see Action Items and Decision Summary at the end *** ** Agenda ** ------------ 1. Roll call 2. Review/approve minutes from 17 August - http://lists.oasis-open.org/archives/dita/200408/msg00051.html 3. Review/revalidate our managing authoring/review process: (based on email from Seraphim Larsen) - Solicit editorial comments from the group during a specific time period -- either email directly to Michael and JoAnn, or post to the TC list - Michael and JoAnn compile the comments, using their discretion on whether to incorporate something or not - If there are conflicts, we should summarize them at the committee meeting, take them to the TC list, and try to resolve them there. If resolution is not possible on the list, then let's bring them to the meeting. 4. Timed discussion on current issues. - Namespace for DITA? - Which version of CALS table model? - Conref and XInclude? (no recent discussion--is this "in" or "out"?) 5. New discussions/issues: - S1000D (general separation of class architecture from implementation vocabularies) - Terminology - http://lists.oasis-open.org/archives/dita/200408/msg00064.html 5. New tasks--discuss DTD cleanup for specification, for example: - Edit and normalize formatting, comments, copyrights, licenses, etc.. - Test the DTDs and Schemas - Test suites for conformance testing? methodologies for testing? - Implementation/interoperability tips for users, vendors 6. AOB? ** Minutes ** ------------- 1. Roll call - Members: Paul Grosso, France Baril, Eliot Kimber, Seraphim Larsen, Bruce Esrig, Robin Cover, Rob Frankland, Sharon Veach, Stanley Doherty, Debbie Lapeyre, Don Day - Observers and visitors: Zachary Taylor, Eric Sirois, Erik Hennum, John Hunt, Tyde Richards - We do have a quorum (11/22). 2. Review/approve minutes from 17 August - http://lists.oasis-open.org/archives/dita/200408/msg00051.html - Minutes approved. 3. Review/revalidate our managing authoring/review process: (based on email from Seraphim Larsen) - Solicit editorial comments from the group during a specific time period -- either email directly to Michael and JoAnn, or post to the TC list - Michael and JoAnn compile the comments, using their discretion on whether to incorporate something or not - If there are conflicts, we should summarize them at the committee meeting, take them to the TC list, and try to resolve them there. If resolution is not possible on the list, then let's bring them to the meeting. - Discussion -- - Why? So we can spend the meeting time dealing with more substantive issues, instead of line-by-line editing. - Have a specific agenda item to cover any open issues -- for example, someone has already submitted an issue to JoAnn/Michael, but it hasn't been addressed in the spec yet. - Perhaps the written current version of the spec could include a list of issues that still need to be resolved. - Paul Grosso -- Yes, carry the issues along with each rev of the spec. When you are ready to release 1.0, you shouldn't have any issues left. - No objections -- Approved by acclamation. 4. Timed discussion on current issues. - Namespace for DITA? - Which version of CALS table model? - Conref and XInclude? (no recent discussion--is this "in" or "out"?) - OK to defer till Michael gets back, so we don't need to discuss these things twice? - No objections, approved by acclamation. 5. New discussions/issues: - S1000D (general separation of class architecture from implementation vocabularies) - Eliot -- DITA's mechanisms fill a real need, so the specialization architecture will "sell itself". - Bruce Esrig -- Maybe it makes sense to separate out the architectural issues -- and highlight them so others can use them? - Erik Hennum -- It seems like we're seeing a trend towards TWO specifications -- and this is something he likes. If we make a clean separation, we'll have a better specification overall. - John Hunt -- Didn't catch his comments. - Don -- Do we need to make this decision today? Probably not -- let's take it to the list for discussion. - Erik Hennum -- He'll take the action item to bring this discussion to the list. - Terminology - http://lists.oasis-open.org/archives/dita/200408/msg00064.html - Erik Hennum took a few minutes to summarize. - What is a "module"? >>> A useful collection of elements. - Erik Hennum and Bruce Esrig are recognized for the excellent work that has gone into this! - We will leave this discussion to the list. 5. New tasks--discuss DTD cleanup for specification, for example: - Edit and normalize formatting, comments, copyrights, licenses, etc.. - Eliot and Debbie -- Take action item to lead this discussion on the list, since they both have strong opinions about how DTDs should be formatted. - Test the DTDs and Schemas - Test suites for conformance testing? methodologies for testing? - Don -- How do we test the DTDs and Schemas? - For example, we want to make sure the content models are complete. - For schemas, how do we ensure that inheritance has been properly indicated? - Robin Cover -- There isn't really anything in place at OASIS for testing -- no real standards or methods. But some issues have appeared with other specs in the past; for example, DTDs that wouldn't parse. - Has anyone seen anything else? - Do we want to "guarantee" that our DTDs have been checked with certain tools? Do we want to offer a "test suite", so that vendors have something to test against (so vendors can say they are "DITA compliant")? - Don will take the action to post something on this to the TC list for further discussion. - Implementation/interoperability tips for users, vendors - Use the DITA Users Group (on Yahoo) as a repository for guidelines, tips, case studies, and so on. - Need to discuss further in future meetings. 6. AOB? - No time -- this item not covered. ** Summary of Decisions ** -------------------------- - Decided to carry a list of open issues along with each revision of the 1.0 spec. When we get to the 1.0 release, hopefully all the issues will have been resolved. - Decided to defer discussion on the following issues till Michael gets back, so we don't need to discuss them twice -- - Namespace for DITA? - Which version of CALS table model? - Conref and XInclude? (no recent discussion--is this "in" or "out"?) ** Action Required ** --------------------- 017 Shawn Jordan -- Post to the TC list his ideas about general extensibility and the creation of new elements not necessarily descended from the Topic element. Still open (not an immediate deliverable -- for post-1.0). 021 JoAnn Hackos, Michael Priestley -- Summarize the discussion of substitution and post to the TC list. Still pending as of 7/20/04. 022 Don, Michael -- Put together a "self-study" tutorial/demo, as per JoAnn's comments regarding the DITA sessions. Still pending as of 7/20/04. 026 Michael -- See how Conref and XInclude contrast with SGML. Still pending as of 7/20/04. 027 Erik Hennum -- Wrap up his thoughts about Conref and XInclude and put them on the list. >>> Done as of 8/24/04. 036 Shawn Jordan -- Investigate where to point the DITA namespace -- where does the URL point? Maybe an OASIS page that describes what DITA does, etc. Still pending 8/17/04. 040 Don -- Cull the past minutes and discussion list to create an inventory of all the things we need to close on in order to create the 1.0 spec. Create a list of these items and post it in the Documents area of the website. >>> This will be ongoing. 042 All -- Consider need for and practicality of 2-3 day face-to-face meeting in late October in order to resolve final technical issues in advance of final editorial work. >>> Let's make this an agenda item for next week (for 8/31). 043 Michael Priestley -- Add a straw-man audience statement to the introduction. 044 All -- Review the .chm file sent out by Michael Priestley located at http://www.oasis-open.org/apps/org/workgroup/dita/download.php/8636/dita spec-intro-08102004.chm and post comments to the TC list. Closed 8/24/04. 045 Erik Hennum -- Start discussion on the TC list about the use of the phrase "document type" in the specification. Closed 8/24/04. 046 Don? -- Incorporate review comments from today's discussion into the 1.0 draft (8/17/04). 047 Erik Hennum -- Start discussion on the TC list about separating the spec into two specs -- one for the architecture and one for the implementation vocabulary. 048 Eliot and Deborah -- Start discussion on the TC list about the formatting of the DTD/schemas. 049 Don Day -- Start discussion on the TC list about testing the DTD/schemas and developing a "test suite". ** Issues to be Resolved ** --------------------------- 005 All -- What should the scope and length of the conceptual introduction be? >>> We'll get this from JoAnn. 006 All -- Should DITA specialization mechanism be documented in a separate specification in order to make it easier to use in other XML applications that otherwise have no relationship to topic-based writing? >>> Ongoing. 007 All -- Decide which version of the CALS table model to use -- either the full CALS model, or the CALS Exchange model. <END> ___________________________________________________________ Seraphim Larsen ICG Technical Publications Sr. Technical Writer Intel Corporation (480) 552-6504 Chandler, AZ The content of this message is my personal opinion only. Although I am an employee of Intel, the statements I make here in no way represent Intel's position on the issue, nor am I authorized to speak on behalf of Intel on this matter. ___________________________________________________________
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]