Re: [docbook-publishers] Groups - DocBook Publishers SC modified

[Scott Hudson <scott.hudson@flatironssolutions.com>]

Here's the additional verbiage for my new action item:

<para>In the interest of providing a schema that meets the needs of the Publishing industry,
            the following considerations were made with regard to the modular approach to the schema
            and the exclusion of certain core DocBook elements:</para>
        <itemizedlist>
            <listitem><para>Simplified markup - the focus should be on the structural, presentational and semantic markup that meets the needs of Publishers.</para></listitem>
            <listitem><para>No technical elements - the vast majority of Publishers will not need the technical elements from core DocBook. For those titles that require technical markup, the inlines can easily be added as a module to the Publishers schema.</para></listitem>
            <listitem><para>Generated text - with the robust DocBook toolchain, most Publishers will want to automate the creation of a Table of Contents and Index.</para></listitem>
        </itemizedlist>
</para>

Please let me know if you'd like to tweak this at all...

Thanks and best regards,

--Scott

keith@oreilly.com wrote:

20081001192603.31264.qmail@eos.oasis-open.org" type="cite">

Minutes added.

 -- Keith Fahlgren


DocBook Publishers SC has been modified by Keith Fahlgren

Date:  Wednesday, 01 October 2008
Time:  12:00pm - 01:00pm PT

Event Description:
The teleconference phone number is +1-877-643-6951. The participant
code is 31804277#. Attendance at teleconferences is restricted to members
(and prospective members) of the subcommittee. For international access, please dial: 302-607-2017.

The DocBook SC uses irc://freenode/dbpub for additional
conference features, such as exchanging URIs, providing out-of-band
comments, and other aspects of the teleconference, so please join us
there if at all possible.

Agenda:
1. Roll call
2. Accepting the minutes[1] of the previous meeting.
3. Next meeting: November 5th, 2008
4. Review of the agenda.
5. Review of open action items
a. Keith to formalize the collection of examples, mark them up, and test against them for dialog and poetry.
b. All: look for good examples of dialog and poetry & submit to Keith
c. All: look for good examples of legal markup
d. Scott: Follow up with Norm on SVN structure & documentation build questions
e. Scott: Ask on DocBook list if we should include common.linking.attributes, based on """Common Linking Attributes
f. Scott: Ask Jon Bosak about permission for use of Shakespeare samples.
g. All: Review specification draft when it becomes available.
h. All: Review the Dublin Core RELAX modeling Scott has implemented in SVN.
i. Scott: Attempt either-or inclusion of db.info version dc.* based on concerns from Norm and other.
6. Proposed Roadmap
a. Identify elements that should be part of Core DocBook
b. Identify potential "modules" for elements currently part of DocBook but belonging to a particular domain.
c. Recommend Core DocBook and proposed modules to DocBook TC
d. Identify general publishing needs not currently met by DocBook
e. Identify additional specific domains within publishing industry that may need specific modules.
f. develop RFEs from identified needs
g. develop DocBook v5.0 schema enhancements from RFEs
h. submit schema enhancements for approval to DocBook TC
8. Review Specification Draft (HTML[2] or PDF[3])
9. Vote on submitting specification draft to DocBook TC
10. Review of Requests for Enhancement

[1]
http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/event.php?event_id=17769
[2] Details: http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/document.php?document_id=28877
Download Document: http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/download.php/28877/publishers.html
[3]
Details:http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/document.php?document_id=28533
Download Document: http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/download.php/28533/publishers.pdf

Minutes:
1. Roll call

Present: Scott Hudson, Dick Hamilton, Keith Fahlgren, Jim Earley

2. Accepting the minutes[1] of the previous meeting.

PASSES

3. Next meeting: November 5th, 2008

No regrets at this time. Scott may have a conflict.

4. Review of the agenda.

New action items:
* Scott: Render new spec document
* Scott: Summarize the main justifications for the removal of elements & modular approach (simplified markup, no technical elements, favor generated over manual TOC and IX).

Continued action items:
* Keith to formalize the collection of examples, mark them up, and test against them for dialog and poetry.
* All: look for good examples of dialog and poetry & submit to Keith
* All: look for good examples of legal markup
* Scott: Ask on DocBook list if we should include common.linking.attributes, based on """Common Linking Attributes
* All: Review specification draft when it becomes available.
* All: Review the Dublin Core RELAX modeling Scott has implemented in SVN.
* Scott: Include the exact number of excluded and included elements from core DocBook in the Spec document
* Scott: Include non-normative usage examples of newly created elements in the Spec document
* Scott: Create online ballot for spec voting


5. Review of open action items
a. Keith to formalize the collection of examples, mark them up, and test against them for dialog and poetry.
CONTINUE
b. All: look for good examples of dialog and poetry & submit to Keith
CONTINUE
c. All: look for good examples of legal markup
CONTINUE
d. Scott: Follow up with Norm on SVN structure & documentation build questions
COMPLETE (last time)
e. Scott: Ask on DocBook list if we should include common.linking.attributes, based on """Common Linking Attributes
CONTINUE
f. Scott: Ask Jon Bosak about permission for use of Shakespeare samples.
COMPLETE (last time)
g. All: Review specification draft when it becomes available.
CONTINUE (new draft coming)
h. All: Review the Dublin Core RELAX modeling Scott has implemented in SVN.
CONTINUE
i. Scott: Attempt either-or inclusion of db.info version dc.* based on concerns from Norm and other.
COMPLETE (last time)
j. Scott: Normalize column headers across tables 1, 3 & 4 in the Spec document
COMPLETE
k. Scott: Add "Description" text for newly created elements in the Spec document
COMPLETE
l. Scott: Include the exact number of excluded and included elements from core DocBook in the Spec document
CONTINUE
m. Scott: Include non-normative usage examples of newly created elements in the Spec document
CONTINUE?
n. Scott: Create online ballot for spec voting
CONTINUE


6. Proposed Roadmap
a. Identify elements that should be part of Core DocBook
b. Identify potential "modules" for elements currently part of DocBook but belonging to a particular domain.
c. Recommend Core DocBook and proposed modules to DocBook TC
d. Identify general publishing needs not currently met by DocBook
e. Identify additional specific domains within publishing industry that may need specific modules.
f. develop RFEs from identified needs
g. develop DocBook v5.0 schema enhancements from RFEs
h. submit schema enhancements for approval to DocBook TC

8. Review Specification Draft (HTML[2] or PDF[3])

Concerns expressed by Dick about:
* The removal of annotations?
  - Keith believes that it introduces significant complexity & also has no current rendering implementation [some explorations on Norm's blog].
  - Perhaps it's more applicable to online presentations rather than publications?
  - Scott finds a note in the minutes from June "cool and powerful, but have to be serious about markup to use effectively. SC feels it is useful as a separate module."
* The removal of indexdiv and tocdiv
  - Scott thinks that we removed those manual elements in favor of generated TOCs and IX.

9. Vote on submitting specification draft to DocBook TC

Pending the identified changes & review, Scott moves that the SC vote in an online ballot to confirm the submission of the specification draft to the TC.
PASSES

We'll try to close the ballot before the next TC meeting.

10. Review of Requests for Enhancement

Will discuss in the next meeting.

[1]
http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/event.php?event_id=17769
[2] Details: http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/document.php?document_id=28877
Download Document: http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/download.php/28877/publishers.html
[3]
Details:http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/document.php?document_id=28533
Download Document: http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/download.php/28533/publishers.pdf




This event is one in a list of recurring events.
Other event dates in this series:

Wednesday, 06 February 2008, 12:00pm to 01:00pm PT
Wednesday, 12 March 2008, 12:00pm to 01:00pm PT
Wednesday, 02 April 2008, 12:00pm to 01:00pm PT
Wednesday, 14 May 2008, 12:00pm to 01:00pm PT
Wednesday, 04 June 2008, 12:00pm to 01:00pm PT
Wednesday, 16 July 2008, 12:00pm to 01:00pm PT
Wednesday, 20 August 2008, 12:00pm to 01:00pm PT
Wednesday, 03 September 2008, 12:00pm to 01:00pm PT
Wednesday, 05 November 2008, 12:00pm to 01:00pm PT
Wednesday, 03 December 2008, 12:00pm to 01:00pm PT
Wednesday, 07 January 2009, 12:00pm to 01:00pm PT
Wednesday, 04 February 2009, 12:00pm to 01:00pm PT

View event details:
http://www.oasis-open.org/apps/org/workgroup/docbook-publishers/event.php?event_id=17772

PLEASE NOTE:  If the above link does not work for you, your email
application may be breaking the link into two pieces.  You may be able to
copy and paste the entire link address into the address field of your web
browser.