Sorry about that. I'll amend the
minutes.
----- Original Message -----
Sent: Wednesday, September 22, 2004 11:05
AM
Subject: Re: [docbook-tc] DocBook
Technical Committee Meeting Minutes: 15 September 2004
Bob,
I had given my regrets verbally at the previous
[August] meeting for the Sept. 15th meeting, knowing that I would be out of
the country on vacation during that time.
____ Nancy Harrison IBM Rational Software Phone:
781-676-2535 nancyph@us.ibm.com
DocBook Technical Committee Meeting Minutes: 15 September
2004 =============================================================
The
DocBook Technical Committee met on Wednesday, 15 September 2004 at 05:00p
EDT (02:00p PDT, 21:00GMT, 22:00BST, 23:00CEST, 06:00JST+, 02:30a
India+).
Agenda
1. Roll call
Present: Steven Cogorno,
Gary Cornelius, Paul Grosso, Dick Hamilton, Scott Hudson, Mark
Johnson, Jirka Kosek, Larry Rowland, Mike Smith, Bob Stayton, Norman
Walsh
Regrets: none
Absent: Adam Di Carlo, Nancy
Harrison
2. Accepted the minutes[1] of the previous meeting
3.
Next meeting: 20 October 2004.
No regrets.
4. Review of the
agenda.
Added committee charter as item 5g. Added review of 4.4 as
item 13a.
5. Review of open action items
a. Mike to
provide a better proposal for choicelist markup.
CONTINUE
b. Bob to identify elements in DocBook that correspond
to valid locations of HTML forms in HTML output.
DONE
d. Norm to generate web pages for 4.2, 4.3, and
4.4x. CONTINUE
e. Norm to write a draft
Committee charter. DONE
f. Gary to investigate
ISO 9000 regarding guidelines for accepting or rejecting
requests. DONE
5g. Committee charter
Norm
circulated a draft [2], and it was commented on by Karl Best of OASIS [3].
Some of the comments may not apply to a committee that mostly does
maintenance of an existing standard. Norm will ask Karl
for clarification. We also need to set specific goals, and
Norm suggested that DocBook 4.4 be done this year, and DocBook 5.0 be
done next year.
Based on Karl's comments, Norm will create a second
draft for the next meeting.
ACTION: Norm to write second draft
charter.
6. Status of DTD version 4.4 beta
Norm released DocBook
4.4b2 on 26 August. [4] He suggested everyone test drive it so that
we can designate it a CR1 release at the next meeting.
7. Bug in
Simplified DocBook 1.1 CR1 (Mark)
Norm identified two bugs: one in
subscript and superscript, and one in system ids pointing to Norm's hard
drive. Suggestions for fixes were accepted.
ACTION: Norm to release
CR2.
8. "Committee Draft" vs. "OASIS Standard".
Bob related
the story of one vendor who was holding off on implementing DocBook 4.3
because it was labeled as a "Committee Draft", which implies that it is not
finished. Norm reported that OASIS removed the designation "Committee
Specification" and so only "OASIS Standard" is available. The latter
requires more work to receive because the full OASIS membership must
vote. Norm thinks the Committee Specification designation may
come back.
ACTION: Norm to write to OASIS requesting restoration of
Committee Specification or equivalent. He should cite Bob's vendor
example.
9. Annotation proposal (Mike). [5] [6]
Norm
implemented an annotation scheme based on Mike's proposal. [7] Discussion
of two content models for annotation: simple and complex. simple is
basically text and would be used in output attribute values and tool tips).
Complex could include paras, lists, tables, etc. and would be
presented in a separate area. Both are needed for different
circumstances Larry suggested two elements with different content
models: annotation and shortannotation or simpleannotation. Steve
suggested a single annotation element with child elements determining
simple or complex. No final decision yet. Decided to post Norm's page
and start a discussion on the list.
ACTION: Norm to post his
annotations page to the mailing list.
10.
Accessibility.
Discussed Larry's list [8] of potential
improvements for accessibility. Many can be done with an
annotation mechanism, so they will be considered together.
Current use of attributes has limitations: some browsers only show
first 100 characters of the title attribute text. One additional area is
making tables more accessible. Norm will forward info from Larry about
tables.
ACTION: Norm to forward Larry's mail about table
accessibility.
ACTION: Norm to contact Mark Pilgrim, author of Dive
Into Accessibility [9], about accessibility issues.
11. Discuss
guidelines for accepting or rejecting requests.
Gary reported on his
review of ISO9000, which recommended that we fully document our process and
results. He suggested creating a flow diagram would help. We
currently use the SourceForge RFE mechanism to track and document the
requests. We could be more careful in adding comments as issues
are resolved. We will consider this item again at the next
meeting.
12. html:form should be available in more places
than in %divcomponent.mix; [10] [11]
Bob sent a proposal to the
list [12] suggesting additional places where the html:form element could
be added. Norm proposed we adopt the proposal. The proposal was
accepted.
13. Review of Requests for Enhancement
To browse a specific RFE, enter the URL (on one line):
http://sourceforge.net/tracker/index.php?func=detail&;
group_id=21935&atid=384107&aid=XXXX
1014806 Add protocol to systemitem class list
Norm proposed that
we accept this. The committee approved this request.
1025286 Support xml:space
Norm proposed that we accept
this. The committee approved this request.
13a. Review
DocBook 4.4 content.
Based on the actions at this meeting, the
committee decided to add the following to 4.4:
- Add 'protocol' to
systemitem class list. - Add optional xml:space="preserved" attribute to
verbatim elements. - Add html:forms hook to 9 more parameter
entities.
ACTION: Norm to produce DocBook 4.4CR1 this
week.
Meeting adjourned at 6:25pm
EDT. ***********************************************************
The following RFEs are awaiting action items
973446 Replace Footnote with Annotation 413389
Enhance METHODNAME and VARNAME (Norm, generic linking)
431411 RFE 70: add generic linking capability (Norm)
522552 Add title attribute to <ulink> element (Mike,
annotations) 565637 Associate non-inline image with
link (Norm, generic linking) 574880 Add annotation
element (Mike) 623524 (Re)Consider "choicelist" markup
(Mike)
The following RFEs are identified as V5.0 or
later
974285 Check floatstyle/float
attributes 958393 remove default class value from
productname 531851 Remove inline person name
elements 532088 Remove RevHistory from qandaentry -
---
[1]
http://lists.oasis-open.org/archives/docbook-tc/200408/msg00012.html [2]
http://lists.oasis-open.org/archives/docbook-tc/200409/msg00009.html [3]
http://lists.oasis-open.org/archives/docbook-tc/200409/msg00010.html [4]
http://lists.oasis-open.org/archives/docbook/200408/msg00029.html [5]
http://lists.oasis-open.org/archives/docbook-tc/200406/msg00003.html [6]
http://lists.oasis-open.org/archives/docbook-tc/200406/msg00005.html [7]
http://norman.walsh.name/2004/09/10/annotations [8]
http://lists.oasis-open.org/archives/docbook-tc/200408/msg00002.html [9]
http://diveintoaccessibility.org/ [10]
http://lists.oasis-open.org/archives/docbook-apps/200406/msg00081.html [11]
http://lists.oasis-open.org/archives/docbook/200404/msg00032.html [12]
http://lists.oasis-open.org/archives/docbook-tc/200409/msg00011.html
Bob
Stayton Sagehill Enterprises DocBook
Consulting bobs@sagehill.net
To unsubscribe from this
mailing list (and be removed from the roster of the OASIS TC), go to
http://www.oasis-open.org/apps/org/workgroup/docbook-tc/members/leave_workgroup.php.
|