RE: [obix] Re: Minor items noted during production of your CSs

From
Considine, Toby <>
Date
2015-10-06T21:58:09+00:00
ID
Thread
RE: [obix] Re: Minor items noted during production of your CSs
Yes the WSDL should.

 

“It is the theory that decides what can be observed."

—Albert Einstein

Toby Considine

Phone: (919)962-9073

Information Technology Services

University of North Carolina

Chapel Hill, NC 

Email: 


Chair, OASIS OBIX Technical Committee

Chair, OASIS WS-Calendar Technical Committee

Editor, OASIS EMIX, Energy Interoperation TC

 

From:  [mailto:]
On Behalf Of Paul Knight

Sent: Tuesday, October 6, 2015 5:53 PM

To: Chet Ensign <>

Cc: 

Subject: [obix] Re: Minor items noted during production of your CSs

 

Additional note: regarding Bindings for OBIX: SOAP Bindings Version 1.0, please also consider if the WSDL file should use the updated (201506) namespace.

 

Best regards,

Paul

 

On Tue, Oct 6, 2015 at 5:24 PM, Chet Ensign <> wrote:

Members of the OBIX TC, 

 

While publishing your new Committee Specifications, we noted the following issues that you may wish to address at the next publication cycle.  

 

- OBIX v1.1

 

The W3C link checker found a broken link to local resource hyperlinked to the word "OASIS" in the Non-Normative reference to "CamelCase". This should be removed.

 

Also, the links below are not broken, but the document does not use the exact URL, and the links are redirected. It may be a good idea to link to the final location, for the sake of speed.

 

- warning Line: 2797 
http://www.w3.org/TR/PNG redirected to 
http://www.w3.org/TR/PNG/

Status: 301 -> 200 OK

The link is missing a trailing slash, and caused a redirect. Adding the trailing slash would speed up browsing.

 

- warning Line: 2795 
http://www.w3.org/TR/2003/REC-PNG-20031110 redirected to 
http://www.w3.org/TR/2003/REC-PNG-20031110/

Status: 301 -> 200 OK

The link is also missing a trailing slash, and caused a redirect. Adding the trailing slash would speed up browsing.

 

- Encodings for OBIX: Common Encodings Version 1.0

 

We noted that the Section 2.6 discussion of namespaces uses "http://docs.oasis-open.org/obix/ns/201410/def" instead of either
http://docs.oasis-open.org/obix/ns/201410/schema (as defined in Section 2.5) or
http://docs.oasis-open.org/obix/ns/201506/schema (as currently defined for OBIX v1.1 (csd04/csprd04/cs01)). You may want to check to see if this is correct. 

 

The examples in Section 4.2 and 4.3 should not use "acme.com", which is a real website. Please replace them with
example.com, a url created for exactly this purpose. 

 

- Bindings for OBIX: REST Bindings Version 1.0

 

In the Non-Normative references, the CoAP reference should cite the RFC instead of Internet draft.

 

The Pinger link check found a broken link for tje non-normative reference to CoAP-OBSERVE. It looks like the Internet draft cited has expired. The TC should update the reference.

 

- Bindings for OBIX: SOAP Bindings Version 1.0

 

Should this document reference the updated OBIX schema and namespace (http://docs.oasis-open.org/obix/ns/201506/schema) instead of
http://docs.oasis-open.org/obix/ns/201410/schema) as it does now. 

 

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 

 

-- 

Paul Knight  - Tel: +1 781-883-1783

OASIS - Advancing open standards for the information society - Document Process Analyst

Identity Ecosystem Steering Group - Framework Management Office