DocBook Technical Committee Meeting Minutes: 10 April 2019

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

The DocBook Technical Committee will met on Wednesday, 10 April 2019

(11am PDT, 12noon MDT, 1pm CDT, 2pm EDT, and 8pm CET)

1. Roll call

Scott Hudson, Bob Stayton, Sabine Ocker, Larry Rowland

2. Accept the minutes [1] of the previous meeting (13 February 2019)

3. Next meeting: 08 May 2019

4. Review of the agenda.

5. Review of open action items

a. Bob to discuss with Jirka how to trim down the assembly model with the xinclude support.

Bob discussed docbook elements in assembly with Jirka, and he says the assembly schema is built from the latest docbook schema files, so it is not a copy. He says he will look at it again to see if it can be reduced. The problem is that we allow all info elements inside <merge> elements, and info includes a lot of biblio elements and legalnotice, which has a lot of docbook content elements. We may have to live with a large assembly schema file, but at least it will not get out of synch with the main docbook schema. COMPLETED

b. Bob to update documentation of Assembly proposals in 5.2
Bob has the content, but needs to understand the process. Bob needs to get more info from Norm on how to maintain the documentation in github.
Bob passed documentation updates for assembly to Norm, who updated the files and rebuilt TDG. For the record, Norm has committed to maintaining the Definitive Guide. COMPLETED

c. Bob/Jirka to include Assembly proposals in 5.2:

i. Jirka provided samples, Bob still needs to test.

i. Grammar is used to identify a particular set of content. A matching grammar should also appear on the transform to convert the content appropriately.

ii. name is used to identify a particular set of content, with a matching transform to some non-standard output.

iii. grammar = inputs to normalize to DocBook

iv. name = outputs from DocBook to a non-standard format

v. set name OR grammar, but not both on both transform and resource

vi. do not use mime type for grammar

**Bob clarify according to minutes: Add @name to transform and @transform to resource. Need to reflect changes (after test) to the documentation.

Jirka has incorporated all the assembly fixes that we approved into the schema, 5.2b06. COMPLETED

d. Extension for synopsis elements

(Issue #111)

ACTION: All to review info element proposals and provide any feedback to Bob. Bob submitted samples to list 11FEB2019. CONTINUED.

ACTION: Bob follow up with the submitter to see if generic info would work. COMPLETED. Submitter suggests synopsisinfo element for other synopsis elements (not the same as info). Consensus that this is acceptable approach.

ACTION: All to review with someone familiar with various programming languages to see if this provides enough detail to map to various languages.

ACTION: Bob to send proposed structure to docbook-apps list to get additional input.

e. Larry to create an integrated proposal for legalsection, all to review before next meeting for approval. CONTINUED.

f. Bob to review models for issue #112 and address schema corrections.

Bob reviewed the section content models regarding refentry and reported on that in a separate email. COMPLETED

g. ALL: start work on action items earlier. CONTINUED

h. Scott to send a reminder mid-month. CONTINUED

i. OASIS has gone through a re-branding effort, which will impact future deliverables. Rework templates?
Bob will download the latest template from OASIS. We use the official templates (Word). COMPLETED.

9. Social media presence for DocBook

Purpose: To raise awareness of actions (votes, calls for information, etc.)

10. Review of Requests for Enhancement

To find a Github issue by number, enter the URL (on one line):

github.com/docbook/docbook/issues

No new issues.

Open Issues (Note: items that have been accepted are still open

on Github until included in a release,

but they are not listed here):

71 license tag

78 Schema website should be updated

88 DB 5.0: @name -> title change not published on docbook.org CLOSED

93 Diff between doc of resource element and Assembly schema

99 Add <endorsement> to <info>

Consider for Publishers.

100 DocBook 5.1 catalog.xml uses incorrect version

103 XML DTD of DocBook 5.1

112 refentry in sect1

111 DocBook Library (tentative name) - Supercedes 107, 108, 109, 110

Links:

[1] https://www.oasis-open.org/apps/org/workgroup/docbook/message.php/201903/msg00006.html

[2] http://github.com/docbook/docbook/issues

Thanks and best regards,

--Scott

Voting member:

Boeing Data Standards Technical Advisory Board

OASIS DocBook TC (Secretary), Publishers SC (Chair)

OASIS DITA TC, Tech Comm SC, LwDITA SC, Learning Content SC (Secretary)

OASIS DITA Adoption TC

OASIS Augmented Reality in Information Products (ARIP) TC

Scott Hudson
Content Technology Strategist
Information and Knowledge Services
_____________________________________
Jeppesen
A Boeing Company

ph: 303.328.6228 | Mobile : 303.350.7934 | scott.hudson@jeppesen.com
55 Inverness Drive East | Englewood, CO 80112 | www.jeppesen.com

This document contains only administrative, uncontrolled data under U.S. International Traffic in Arms Regulations.

docbook-tc message