Skip to content
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

Review Chapter 6.7 in relation to Binding Templates 4.1 #617

Closed
egekorkan opened this issue Oct 26, 2021 · 4 comments
Closed

Review Chapter 6.7 in relation to Binding Templates 4.1 #617

egekorkan opened this issue Oct 26, 2021 · 4 comments
Assignees

Comments

@egekorkan
Copy link
Contributor

Currently, architecture talks about protocol bindings. This should be reviewed to sync with the 4.1 of the Binding Templates

@egekorkan egekorkan self-assigned this Oct 26, 2021
@egekorkan
Copy link
Contributor Author

In addition to my points in #625 , below are my review points:

  • 8.7.2 mentions transfer protocol and not transport protocol

@mlagally
Copy link
Contributor

mlagally commented Dec 9, 2021

Arch call on Dec 9th:
@egekorkan Do you plan additional work for that?

@egekorkan
Copy link
Contributor Author

My review:

There are 3 types of requirements in chapter 8.7:

  1. 8.7.1 Hypermedia-driven
  2. 8.7.2 URIs
  3. 8.7.3 Media Types

These are indeed correct and somewhat reflected in the binding specification at chapter 4.1.1 Creating a Protocol Binding. I say somewhat because:

  1. 8.7.1 Hypermedia-driven : This basically says that there has to be forms and how forms can be generated (by the Thing itself or by an external entity). This should be made more clear and ideally refer to TD spec and the assertion in the first sentence can be removed since it is also specified in the TD spec.
  2. 8.7.2 URIs : Correct but there are discussions everywhere about making the IANA registration mandatory or not
  3. 8.7.3 Media Types : I think this should be moved since media type and protocol are different things in my opinion. This corresponds to chapter 4.2 of the binding templates.

Even though this section is duplicate to binding templates, I would not oppose to its existence if the assertions are removed and some examples are given. Actually, this is a perfect place to put some of the orphaned sections of the binding template such as B.1 (https://w3c.github.io/wot-binding-templates/#form-element)

@mlagally mlagally changed the title Review Chapter 8.7 in relation to Binding Templates 4.1 Review Chapter 6.7 in relation to Binding Templates 4.1 Mar 31, 2022
@mlagally
Copy link
Contributor

Arch call on June 23rd: no further work is expected. Closing the issue.
Please open individual tasks, if necessary.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants