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 TC Admin comments on UBL Naming and Design Rules Version 3.0 CNPRD01


Members of the UBL,

TC Administration provides the following comments for the public review of  http://docs.oasis-open.org/ubl/UBL-NDR/v3.0/cnprd01/UBL-NDR-v3.0-cnprd01.html

1) In the beginning of Section 2, there is a link to a resource at "http://goo.gl/DgMAqy."

First, the Naming Directives state that "TCs must not use URI aliasing by any means, including ... constructing URIs for canonical OASIS resources by using redirects supported by services on other Internet domains (e.g., http://tinyurl.com/, http://purl.oclc.org/, http://bit.ly/)."

The main reason for this is to ensure transparency. A redirected link like this seems to hide the source you point to. We ask that you replace this in subsequent editions with the actual, physical link to the target. 

Second, we ask why this content is separate? The link appears to point to instructions that ought to be documented in an approved work product. If this documents rules that people need to follow for some purpose, then it should not be kept in some ad hoc location and document subject to change or elimination without warning. 

2) The URI for TC name in Front Matter is given as "http://www.oasis-open.org/committees/ubl/" - should use https. The same issue applies to the URIs in the Status section - for comments and to the TC - both should use https:

3) Because this is a Committee Note - and thus can have no normative, prescriptive content - there can logically be no "Normative" references. Please change the heading to References and eliminate "Normative" and "Non-Normative." 

4) In section 1.3 Normative references, the first reference [BD-NDR] has a mismatch between the visible URI and the actual link. The visible link is to the CSD at "http://docs.oasis-open.org/ubl/Business-Document-NDR/v1.0/csd01/Business-Document-NDR-v1.0-csd01.html." But the underlying link is to the CND "http://docs.oasis-open.org/ubl/UBL-NDR/v3.0/cnprd01/UBL-NDR-v3.0-cnprd01.html", which is this document itself.

Please let us know if you have any questions on 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 


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