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

[Hussein Shafie <hussein@xmlmind.com>]

Hello,

It's impossible for us to comment on DocBook Schema V5.2 because aside 
your short document describing the V5.2 changes, we failed to find any 
usable documentation about DocBook V5.2.


* In "DocBook 5.2: The Definitive Guide"

https://tdg.docbook.org/tdg/5.2/

attributes other than "Common linking attributes" are not documented. 
Or, may be they are, but there are no links from an element to all its 
attributes. See for example: "blockquote", 
https://tdg.docbook.org/tdg/5.2/blockquote


* "DocBook 5.2: The Definitive Guide" does not contain any information 
about the specificities of the (XInclude) transclusion supported by 
DocBook V5.2. For example, about the new trans:idfixup, trans:suffix, 
and trans:linkscope common attributes.

All we have found is this article by Jirka Kosek: "DocBook Transclusion",

https://docbook.org/docs/transclusion/transclusion

but it's quite old ("08 Jan 2015") and unlikely to be up to date.



Thank you for your help.

---
PS: Some of our XMLmind products and open source software support 
DocBook V5.1 and we would like to update them to support V5.2 in the 
next few months.



On 11/20/23 20:28, Chet Ensign wrote:
> OASIS members and other interested parties,
>
> 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) maintained by the DocBook Technical 
> Committee. It 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Â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 <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 <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 <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 <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 <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/ 
> <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 
> <https://www.oasis-open.org/committees/docbook>
>
> [2] Approval ballot:
> https://www.oasis-open.org/committees/ballot.php?id=3806 
> <https://www.oasis-open.org/committees/ballot.php?id=3806>
>
> [3] Statements of Use:
>
> - Norm Tovey-Walsh
> https://lists.oasis-open.org/archives/docbook-tc/202310/msg00002.html 
> <https://lists.oasis-open.org/archives/docbook-tc/202310/msg00002.html>
>
> - XML Press
> https://lists.oasis-open.org/archives/docbook-comment/202309/msg00000.html <https://lists.oasis-open.org/archives/docbook-comment/202309/msg00000.html>
>
> - SUSE documentation team
> https://lists.oasis-open.org/archives/docbook-comment/202310/msg00000.html <https://lists.oasis-open.org/archives/docbook-comment/202310/msg00000.html>
>
> - Jira Kosek
> https://lists.oasis-open.org/archives/docbook-comment/202310/msg00001.html <https://lists.oasis-open.org/archives/docbook-comment/202310/msg00001.html>
>
> [4] http://www.oasis-open.org/policies-guidelines/ipr 
> <http://www.oasis-open.org/policies-guidelines/ipr>
>
> [5] https://www.oasis-open.org/committees/docbook/ipr.php 
> <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 
> <https://www.oasis-open.org/policies-guidelines/ipr/#RF-on-Limited-Mode>
>
>
> --
> 	
>
>
>       ChetÂEnsign
>
> Chief Technical Community Steward
>
> OASIS Open
>
> 				
>
> 	+1 201-341-1393 <tel:+1+201-341-1393>
>
> 	chet.ensign@oasis-open.org <mailto:chet.ensign@oasis-open.org>
>
> 	www.oasis-open.org <https://www.oasis-open.org>

--
Hussein SHAFIE, Product Manager, hussein@xmlmind.com
XMLmind Software, 35 rue Louis Leblanc, 78120 Rambouillet, France
Phone: +33 (0)9 52 80 80 37, Fax: +33 (0)9 57 80 80 37, www.xmlmind.com