New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
update Section 8.3 #1301
update Section 8.3 #1301
Conversation
I understand that this change is intended to make it possible to describe existing IoT protocols like MQTT and Modbus in a Thing Description, and whilst I don't personally agree with that I accept that others want to do it. My concern with this wording though is that because the terms "defacto" and "established" are so open to interpretation it essentially introduces a loophole which can allow any protocol to be a WoT protocol, including non-Internet protocols. In fact it is so open that it arguably makes the assertion meaningless. If I've understood correctly then someone could theoretically make up their own unofficial URI scheme for a non-IP protocol like Zigbee or Z-Wave and then create a protocol binding template which uses that URI scheme. This blows open the number of protocols that a WoT Consumer might be expected to support even further and removes the compromise we reached to ensure that this couldn't happen. I'm afraid I don't have an alternative proposal which can work for the MQTT and Modbus use cases but not for the Zigbee and Z-Wave use cases (other than getting their standards bodies to register official URI schemes with IANA), but I'm interested to hear others' views on this. |
from today's TD call:
|
I sort of forgot what I exactly had to do but I have added the link for the relevant part in the binding spec |
@@ -5089,7 +5089,8 @@ <h3>Protocol Bindings</h3> | |||
<span class="rfc2119-assertion" id="bindings-requirements-scheme"> | |||
Every form in a WoT Thing Description MUST follow the requirements | |||
of the <a>Protocol Binding</a> indicated by the URI scheme [[!RFC3986]] of its | |||
<code>href</code> member. | |||
<code>href</code> member as indicated by the Binding Templates specification at <a href="https://w3c.github.io/wot-binding-templates/#creating-a-new-protocol-binding">Creating a New Protocol Binding</a>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This language is difficult to understand, since it refers the entire binding specification. The implication on the URI scene should be clarified.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It shouldn't be the case, for me the relative part is shown when I click on https://w3c.github.io/wot-binding-templates/#creating-a-new-protocol-binding
from today's TD call:
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This language contains a reference to the binding template spec in a RFC assertion.
The sentence needs to be split and move the binding templates out of the normative part.
addresses issue w3c/wot-architecture#639
Preview | Diff