TC Admin comments on DocBook Version 5.1 CSPRD01

Members of the DocBook TC,

During our publication and release of DocBook V5.1 for public review, we noted a few minor issues to address in subsequent editions. TC Administration provides these comments for the public review of the above Committee Specification Drafts. Public review was announced in https://www.oasis-open.org/news/announcements/30-day-public-review-for-docbook-v5-1-ends-april-21st

- The PDF version has no footers or page breaks as we do in OASIS specifications. See for example http://docs.oasis-open.org/emergency/edxl-have/v2.0/csprd01/edxl-have-v2.0-csprd01.pdf

- Appendix subsections should be numbered "A.1... A.2" etc.

- On the cover page, the stage should have a "/" and a soft return, i.e.

Committee Specification Draft 01 /

Public Review Draft 01

- The month in the date should be spelled out.

- Under Related work, please cite to http://docs.oasis-open.org/docbook/specs/docbook-5.0-spec.html not to the copy of docbook.org

- For the status section, please use the text we publish with other specifications. See for example the status section under http://docs.oasis-open.org/emergency/edxl-have/v2.0/csprd01/edxl-have-v2.0-csprd01.html

- If possible, in the Citation format block, please put a line break after the label [DocBook-5.1]

Thanks & please let us know if you have any questions about these.

/chet
----------------
Chet Ensign
Director of Standards Development and TC Administration
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn: http://linkd.in/OASISopen
Twitter: http://twitter.com/OASISopen
Facebook: http://facebook.com/oasis.open

docbook-comment message