Project news

Invitation to comment on DocBook Schema V5.2 before call for consent as OASIS Standard – ends January 18th

The widely-adopted XML schema for marking up books of all kinds is now presented for public review prior to its submission to the members of OASIS as a candidate for OASIS Standard.

OASIS and the DocBook TC [1] are pleased to announce that The DocBook Schema Version 5.2 is now available for public review and comment.

DocBook is a schema (available in languages including RELAX NG, SGML and XML DTDs, and W3C XML Schema) that is particularly well suited to books and papers about computer hardware and software.

Because it is a large and robust schema, and because its main structures correspond to the general notion of what constitutes a “book,” DocBook has been adopted by a large and growing community of authors writing books of all kinds. DocBook is supported “out of the box” by a number of commercial tools, and there is rapidly expanding support for it in a number of free software environments. These features have combined to make DocBook a generally easy to understand, widely useful, and very popular schema. Dozens of organizations are using DocBook for millions of pages of documentation, in various print and online formats, worldwide.

The TC received four Statements of Use from from Norm Tovey-Walsh, XML Press, the SUSE documentation team, and Jira Kosek. [3].

The candidate specification and related files are available here:

The DocBook Schema Version 5.2
Committee Specification 01
19 July 2023

Editable source (Authoritative):
https://docs.oasis-open.org/docbook/docbook/v5.2/cs01/docbook-v5.2-cs01.docx

HTML:
https://docs.oasis-open.org/docbook/docbook/v5.2/cs01/docbook-v5.2-cs01.html

PDF:
https://docs.oasis-open.org/docbook/docbook/v5.2/cs01/docbook-v5.2-cs01.pdf

For your convenience, OASIS provides a complete package of the specification document and any related files in ZIP distribution files. You can download the ZIP file at:

https://docs.oasis-open.org/docbook/docbook/v5.2/cs01/docbook-v5.2-cs01.zip

Public Review Period

The 60-day public review starts 20 November 2023 at 00:00 UTC and ends 18 January 2024 at 23:59 UTC.

This is an open invitation to comment. OASIS solicits feedback from potential users, developers and others, whether OASIS members or not, for the sake of improving the interoperability and quality of its technical work.

Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility as explained in the instructions located via the button labeled “Send A Comment” at the top of the TC public home page, or directly at:

https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=docbook

Comments submitted by for this work and for other work of this TC/OP are publicly archived and can be viewed at:

https://lists.oasis-open.org/archives/docbook-comment/

All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members. In connection with this public review of “DocBook V5.2,” we call your attention to the OASIS IPR Policy [4] applicable especially [5] to the work of this technical committee. All members of the TC/OP should be familiar with this document, which may create obligations regarding the disclosure and availability of a member’s patent, copyright, trademark and license rights that read on an approved OASIS specification.

OASIS invites any persons who know of any such claims to disclose these if they may be essential to the implementation of the above specification, so that notice of them may be posted to the notice page for this TC’s work.

Additional information

[1] DocBook TC
https://www.oasis-open.org/committees/docbook

[2] Approval ballot:
https://www.oasis-open.org/committees/ballot.php?id=3806

[3] Statements of Use:

[4] http://www.oasis-open.org/policies-guidelines/ipr

[5] https://www.oasis-open.org/committees/docbook/ipr.php
RF on Limited Terms Mode
https://www.oasis-open.org/policies-guidelines/ipr/#RF-on-Limited-Mode

The work of OASIS is supported by organizations from around the world. Members include:

View all our members