search

w3c / wot-binding-templates

Web of Things (WoT) Binding Templates
http://w3c.github.io/wot-binding-templates/
Other
22 stars 25 forks source link

Specifications of Protocols submitted to node-wot #124

Open egekorkan opened 3 years ago

egekorkan commented 3 years ago

Lately, there has been two PRs to node-wot that introduce two new protocols from people we do not know. These are about the Google's firebase (https://github.com/eclipse/thingweb.node-wot/pull/417) and the M-Bus protocol (https://github.com/eclipse/thingweb.node-wot/pull/460). There are also previous contributions of OPC-UA (https://github.com/eclipse/thingweb.node-wot/tree/master/packages/binding-opcua), Netconf (https://github.com/eclipse/thingweb.node-wot/tree/master/packages/binding-netconf) and platform related protocols for Fujitsu and Oracle. Now that #123 is making it possible to have specifications that can be separate, it makes it easier to document such bindings. The question is how to proceed. Below are some options:

  1. Ignore these protocols in node-wot and hope for the authors to be W3C WoT WG members and write a specification document
  2. Copy the contents from their code to make it into a specification document. This is not so trivial since the ones who write the specification are not the experts and also maintainability is questionable. We can ask the authors of the bindings at node-wot to review it though.
  3. Simply link to them as example implementations without writing them in a specification.
Citrullin commented 3 years ago

I tend to go for the first option. Firestore is a proprietary solution from Google. Google is a member in the W3C. So, if they are interested in providing a binding template for their commercial products, they are able to participate in the group and write a specification for it, which we might add. Said that, the Eclipse foundation is, of course, free to implement also parts which are non recommendation conform. So, if they see a benefit in using it, for whatever reason, they can, of course, do so.

egekorkan commented 3 years ago

The problem with option 1 are that:

  1. They may never do it
  2. People who are not aware of node-wot, will not know about the usability of these protocols in the WoT.
  3. There are also standard (non-product) protocols like MBus, Netconf and OPCUA