OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

ubl-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Public review comments for seven UBL documents


Hi all,
(combining all comments to avoid extra email clutter)

During preparation of the documents for publication, the OASIS TC Administration team noted several items which we would like to bring to the TC's attention. We have listed these with the associated documents below.

Most of these items are editorial, or related to broken links, rather than substantive comments on the content of the documents.

csd03-UBL-2.3
- (corrected in publication) - schema files in /xsd and /xsdrt directories - we modified incorrect links in the commented header text blocks pointing to "csd02wd01" and "csprd03" to instead point to csd03 (about 200 file headers modified)

Business-Document-NDR-v1.1-csd03
- Appendix A.2 "Package structure" refers to a file named "Business-Document-NDR-v1.1-csd03-summary.xml", but the publication package does not include this file. However, it includes a file named "Business-Document-NDR-v1.1-csd03-summary.ent"
- 3 bad links to .xsd files:
-- BDNDR-UnqualifiedDataTypes-1.1.xsd - in Section 6.8
--- bad hyperlink to https://docs.oasis-open.org/ubl/Business-Document-NDR/v1.1/csd03/xsd/BDNDR-UnqualifiedDataTypes1.1.xsd (missing hyphen before "1.1")
-- BDNDR-UnqualifiedDataTypes-1.1.json - in Section 6.8
--- bad hyperlink to https://docs.oasis-open.org/ubl/Business-Document-NDR/v1.1/csd03/json/BDNDR-UnqualifiedDataTypes.json
--- should be .../jsonschema/...; also filename is missing the final numbers - "-1.1.json".
--- The full link should be "https://docs.oasis-open.org/ubl/Business-Document-NDR/v1.1/csd03/jsonschema/BDNDR-UnqualifiedDataTypes-1.1.json")
-- CCTS_CCT_SchemaModule.xsd - in Section 6.9
--- bad hyperlink to https://docs.oasis-open.org/ubl/Business-Document-NDR/v1.1/csd03/CCTS_CCT_SchemaModule.xsd
--- should be "https://docs.oasis-open.org/ubl/Business-Document-NDR/v1.1/csd03/xsd/BDNDR-CCTS_CCT_SchemaModule-1.1.xsd"

General comments on all of the following five Committee Note Draft documents:
- The use of a reference to RFC 2119 and usage of any requirements-related keywords is not considered appropriate for non-standards track OASIS Committee Notes, and should be removed for future publication stages (alternatively, they may be published as Specifications).
- The "Notices" sections of four of the five CNDs (excepting UBL-NDR) are the complete standards-track versions, instead of the abbreviated "Note" versions.

UBL-2.1-JSON-v2.0-cnd01
- no items noted beyond the general CND comments.

UBL-2.2-JSON-v1.0-cnd01
- no items noted beyond the general CND comments.

UBL-2.3-JSON-v1.0-cnd01
- broken/premature link to https://docs.oasis-open.org/ubl/os-UBL-2.3/xml/ in Section 3.1

UBL Governance-v1.1-cnd01
- (not part of the specification per se) There are two broken links in the front page "Related work" section - to the current stages of UBL-2.3 and UBL-2.2
- broken link in Section 4.5 for [UBL-NDR] - has "cnd01wd01"
- Note that for each of these broken links, there is an accompanying "Latest version" link which is okay. We recomment simply using these "Latest version" links to simplify ongoing editorial effort, unless there is a need to indicate a specific stage or version.
- minor item: for future publications, there is no need for "(Non-Normative)" in Appendix D Acknowledgements, since the entire document is non-normative. (non-standards track)

UBL-NDR-v3.1-cnd01
- (only in the PDF format) both Figure 2 and Figure 3 are corrupted . They appear to be okay in the HTML.
- There are a number of broken links to items in the non-existent directory http://docs.oasis-open.org/ubl/os-UBL-2.3/*
(This directory may eventually exist, although in any case, it should be referenced using https:)
- (not part of the specification per se) In "Related work", the reference to UBL 2.3 links only to the non-existent file http://docs.oasis-open.org/ubl/csprd03-UBL-2.3/UBL-2.3.html (This is published as csd03 only).
- minor item: for future publications, there is no need for "(Non-Normative)" in the titles of Appendix A and B, since the entire document is non-normative. (non-standards track)

Best regards,
Paul
--
OASIS - Advancing open standards for the information society


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]