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

add default values to Class Definitions (Chapter 5.2) #1298

Open
mlagally opened this issue Nov 24, 2021 · 1 comment
Open

add default values to Class Definitions (Chapter 5.2) #1298

mlagally opened this issue Nov 24, 2021 · 1 comment
Labels
Defer to TD 2.0 Testing Tooling topics around tooling for the specification

Comments

@mlagally
Copy link
Contributor

mlagally commented Nov 24, 2021

The table in chapter 5.2 contain the text "with default", where the default values are listed in chapter 5.3.
This requires that a reader has to jump between different sections of the document if he tries to understand chapter 5.2., which is very inconvenient for a reader/reviewer.

Suggest to additionally add them to the table, for example: "with default true"

The summary table in Chapter 5.3 can remain as it is.

@sebastiankb sebastiankb added the Editorial Issues with no technical impact on implementations label Nov 30, 2021
@egekorkan
Copy link
Contributor

I had a look at this and it is sadly not an editorial change. The default values (rows) at https://w3c.github.io/wot-thing-description/#sec-default-values are each a separate assertion. The vocabulary tables are also row of separate assertions. Given that vocabulary tables explain the meaning of the term and its type, whereas the default values give only the value, they cannot be the same assertion. One can implement the term but never handle its default value. In the current publication, I do not see any way we can achieve this since it implies changes to the assertions and I do not know how it can be easily done in the future. There can be another script somewhere that generates an additional assertion but it means quite some tooling.

@egekorkan egekorkan added Testing Defer to TD 2.0 Tooling topics around tooling for the specification and removed Editorial Issues with no technical impact on implementations labels May 17, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Defer to TD 2.0 Testing Tooling topics around tooling for the specification
Projects
None yet
Development

No branches or pull requests

3 participants