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

Confusing Explanation for Figure 29 #899

Open
egekorkan opened this issue Mar 31, 2023 · 1 comment
Open

Confusing Explanation for Figure 29 #899

egekorkan opened this issue Mar 31, 2023 · 1 comment

Comments

@egekorkan
Copy link
Contributor

egekorkan commented Mar 31, 2023

Above Figure 29 there is the following text:

In this figure the WoT building blocks are highlighted with black outlines. The WoT Thing Description is a key building block that provides metadata describing a Thing and its network interface. Security, a cross-cutting concern, is separated into public and protected private components. The WoT Scripting API is optional and the Binding Templates are informative. The WoT Discovery building block defines mechanisms for distributing Thing Descriptions; a Thing can provide Thing Descriptions directly, or they can be provided by a Thing Description Directory service.

This text is quite confusing and mixes building blocks with the specification normativeness. It says highlighted in black outlines but are dotted ones also building blocks? It seems that the initial intention was to say that the dotted ones are informative blocks but Discovery is not. I would not bother making such a difference since whether a block is informative or not does not change this general architecture.
We can talk whether a block is optional for an implementation or not but in that case binding templates are not really optional, each td has binding template vocabulary one way or another. Each Thing has private security data as well (unless nosec).

Also, what does the arrow between Thing and TDD imply?

Also, this figure does not have profiles.

Figure 29 for easy reference:
image

@egekorkan
Copy link
Contributor Author

Also there are disrepencany between this and the following figures:

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