[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Meeting Minutes 7/27/04 -- DITA Technical Committee
Meeting Minutes 7/27/2004 -- DITA Technical Committee
*** Please see Action Items and Decision Summary at the end ***
** Agenda **
------------
1. Roll call
2. Review/approve minutes from 20 July
- http://lists.oasis-open.org/archives/dita/200407/msg00040.html
3. Continue working on outlines for the initial specifications.
- Templates issue:
- Report from Eliot on substructure conventions? Specs
we should emulate?
- Content:
- Guidance from Michael and JoAnne. Latest outline:
http://lists.oasis-open.org/archives/dita/200407/msg00013.html
- DITA Map/task map for the spec documents?
- Schedule:
- Assess a realistic target date for draft: checkpoints:
assigned portions, initial draft, reviews, final
review/handoff
4. Progress on remaining issues currently in discussion. All
are close to making final decisions for 1.0:
- Conref and XInclude?
- Namespace for DITA? See discussion on list.
- Which version of CALS table model?
5. AOB?
** Minutes **
-------------
1. Roll call --
- Members:
- France Baril
- JoAnn Hackos
- Shawn Jordan
- Mary McRae
- Paul Grosso
- Stanley Doherty
- Eliot Kimber
- Mike Wethington
- Seraphim Larsen
- Indi Leipa
- Yas Etessam
- Wendy Hambleton
- Sharon Veach
- Don Day
- Observers and visitors:
- Erik Hennum
- Eric Sirois
- Deborah Lapeyre
- Alan Houser
- We do have a quorum.
2. Review/approve minutes from 20 July
- http://lists.oasis-open.org/archives/dita/200407/msg00040.html
- In the namespace discussion, it should have said that
Mary McRae is "perfectly happy with a URI namespace",
not an "HTML namespace".
- A few other comments were posted in the minutes.
- Went through the Action Items and Issues, marked
several as closed.
- Minutes approved as amended.
3. Continue working on outlines for the initial specifications.
- Templates issue:
- Report from Eliot on substructure conventions? Specs
we should emulate?
- Skipped; Eliot hasn't been able to work on this
yet.
- We will examine this more closely when we get
closer to needing to decide on a format for the
specification.
- Mary McRae --
- She will be joining OASIS soon, and one of her
tasks will be to handle the templates. It is
perfectly acceptable to author the DITA spec in
DITA -- don't need to use DocBook.
- Also, they plan to provide an XSLT for both
DocBook and DITA so other standards owners can
easily author their specs in DocBook or DITA.
- JoAnn -- They are already planning to do the spec in
DITA. But they need a transform to create the PDF of
the spec.
- Eliot will see if he can find time to create an FO
for this.
- Arbortext might also be able to come up with
something.
- Schedule:
- Assess a realistic target date for draft: checkpoints:
assigned portions, initial draft, reviews, final
review/handoff
- Erik Hennum -- Maybe we need to list an inventory
of all the things we need to close on?
- JoAnn -- When will Michael Priestley be back?
- Final word -- he'll be back on July 29th
before he leaves again for most of August.
- Seraphim -- Suggestion to cull the discussion list
in order to make a complete list of open tasks.
- Don -- Will take this action. He will create
a document in the Documents area of the web site
to track this.
- Don -- What milestones need to occur before we can
hand off to OASIS?
- Three sections, three weeks of review per
section -- Nine weeks total for initial
review.
- Then two weeks for final review.
- This plan was approved.
- Don -- Let's set the new deadline as Tuesday,
November 16th. Then we'll back the schedule out
from there.
- Note from Seraphim -- Perhaps this would create
a schedule something like this:
- 17 Aug 2004
- First major milestone -- complete
first draft of first section and send
out for review.
- Begin review of 1st section.
- 07 Sep 2004
- Complete review/revision of 1st
section; begin review of 2nd section.
- 28 Sep 2004
- Complete review/revision of 2nd
section; begin review of 3rd section.
- 19 Oct 2004
- Complete review/revision of 3rd
section; beginning of final review
- 02 Nov 2004
- Complete final review
- 16 Nov 2004
- Release 1.0 spec to OASIS
- Content:
- Guidance from Michael and JoAnne. Latest outline:
-
http://lists.oasis-open.org/archives/dita/200407/msg00013.html
- Do we need more/less detail?
- Paul -- Let's have at least a few words on
every topic. Leaving things out will be
frustrating for potential adopters.
- JoAnn -- Send specific topics to JoAnn and Michael
offline.
- JoAnn -- The section requiring the most writing
will be the intro -- This is where the new user
will first meet DITA, and there are also many new
items here such as the namespace issues, that
aren't even resolved yet.
- Don -- Send comments to JoAnn this week.
- DITA Map/task map for the spec documents?
- Not covered.
4. Progress on remaining issues currently in discussion. All
are close to making final decisions for 1.0:
- Conref and XInclude?
- Not covered
- Namespace for DITA? See discussion on list.
- Eliot -- Wants namespaces so a document can be
unambiguously associated with DITA.
- Schema and DTD --
- Eliot -- Schema and DTD are just two ways of
repesenting the rules, which are abstract.
- Erik -- Should we define the spec as a DTD or
a Schema? For example, should we define the spec
as a DTD, and then derive the schema from that?
- Eliot -- No, the rules are abstract and can be
defined independently, and then the DTD and schema
are both written based on that.
- We're out of time, let's move the discussion to
the list.
- Which version of CALS table model?
- Not covered.
5. AOB?
** Summary of Decisions **
--------------------------
- Decided on schedule for the 1.0 spec --
- Target release date -- Tuesday November 16th.
- Plan: There are three sections, requiring three weeks of
review per section; to be followed by a comprehensive
final review lasting two weeks.
** 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.
024 Eliot -- Find out exactly how to entitle the subsections
within the two specifications (as "sub specification", or as
"Part 1, part 2, etc.", or in some other way).
- Eliot sent email to specification support person, but
no response back yet. (6/29/04)
- Also Eliot should ask if OASIS can provide any
examples of well-written specs (in regard to content,
not format)
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. Still pending as of
7/27/04.
029 Eliot -- Wrap up the "set of namespaces" as a proposal for
the TC to approve next week. Marked as completed 7/27/04 --
covered elsewhere.
031 Don -- Ask Eliot whether the conref/xinclude issues must be
resolved for 1.0 or can be deferred. Don asked but hasn't
received a response. Completed as of 7/27/04.
033 Don -- Ask all the owners of "Issues to be Resolved", below,
to move the issues to the list and get them off the minutes.
Completed as of 7/27/04.
034 Don -- Contact principles on the Conref and XInclude
discussion and drive to closure to a unified proposal.
Completed as of 7/27/04.
035 Don -- Contact principles on the Namespace issues -- is it
just a string, or is it a URL? >>> It is a URI namespace.
This item closed as of 7/27/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.
037 Don -- Find someone to investigate the impact on those with
legacy content of moving from the CALS model to the HTML
model.
038 Debbie Lapeyre -- Take the table-model discussion to the
list. Completed as of 7/27/04.
039 Unassigned -- Find more information comparing the CALS and
HTML table models. >>> There was some discussion on the
list, and Don will post a URL to a discussion on the DocBook
list, so consider it closed as of 7/27/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.
041 All -- Send comments on spec 1.0 to JoAnn this week.
** Issues to be Resolved **
---------------------------
001 Bruce Esrig -- How does specialization interact with maps?
Let's move all these issues to be discussed on the list.
Closed as of 7/27/04.
002 Bruce Sesnovich -- How do we resolve name conflicts? (E.g.
two people create two different specializations off the same
parent topic, but give them the same name). Let's move all
these issues to be discussed on the list. Closed as of
7/27/04.
003 Don Day -- Let's explore tools that can make the
specialization process easier (that is, help automate it --
it is simple but tedious). Maybe there are vendors who would
be interested in working with us on this. Let's move all
these issues to be discussed on the list. Closed as of
7/27/04.
004 Bruce -- We need to go beyond naming conventions, and have
a formal syntax that captures the specialization structure.
Let's move all these issues to be discussed on the list.
Closed as of 7/27/04.
<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]