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 for unnecessary normative statements [TAG feedback] #817

Closed
rhiaro opened this issue Jul 25, 2022 · 3 comments
Closed

Review for unnecessary normative statements [TAG feedback] #817

rhiaro opened this issue Jul 25, 2022 · 3 comments
Assignees
Labels
by CR transition tag-needs-resolution Issue the Technical Architecture Group has raised and looks for a response on.

Comments

@rhiaro
Copy link
Member

rhiaro commented Jul 25, 2022

Some normative statements appear to provide context/background/similar rather than strictly describe normative requirements - eg. in 8.1.2 Links, that "Things MUST be hosted on networked system components [..]". Apologies if this has been misunderstood, but this seems more of a foundational premise than a feature to test for conformance purposes.

Suggest reviewing for such statements and rephrasing/moving/removing as appropriate.

(From w3ctag/design-reviews#736)

@mlagally mlagally added tag-needs-resolution Issue the Technical Architecture Group has raised and looks for a response on. address TAG feedback and removed address TAG feedback tag-needs-resolution Issue the Technical Architecture Group has raised and looks for a response on. labels Aug 4, 2022
@mlagally
Copy link
Contributor

mlagally commented Sep 1, 2022

Arch call on Sept 1st:
We will review all assertions and identify those that are not testable features as part of the implementation report work.
These assertions will be converted to regular text.

@mlagally
Copy link
Contributor

mlagally commented Sep 8, 2022

Arch call on Sept 8th:
Several normative statements have been weakened from "MUST" to "SHOULD", specifically in the security section. Some redundant assertions have been removed in security.

Group-wide review will be performed when the contributions from implementors for the implementation report will be available.
We are collecting testing input and will check, which assertions need to be clarified and which are at risk.

@mlagally
Copy link
Contributor

mlagally commented Oct 13, 2022

Arch call on Oct 13th:
Reviewed at risk assertions in the implementation report:
https://w3c.github.io/wot-architecture/testing/report11.html

Review has been done, there are ~20 at risk items in S&P section, 2 are in the remainder of the document.

For CR publication we have to update the "at risk list" to call out the sections and at risk items.
Add text to the S&P section via issue #854:
"Several assertions, marked in yellow in this section are at risk. If insufficient testing results have been obtained by PR transitions, these will be converted to informative text."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
by CR transition tag-needs-resolution Issue the Technical Architecture Group has raised and looks for a response on.
Projects
None yet
Development

No branches or pull requests

3 participants