Skip to content

Non-normative security and privacy section contains normative RFC 2119 keywords #40

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

Closed
domenic opened this issue Jun 20, 2017 · 2 comments

Comments

@domenic
Copy link

domenic commented Jun 20, 2017

It seems like the section should just be marked normative

@mgiuca
Copy link
Collaborator

mgiuca commented Jun 21, 2017

I see, so you should not have those keywords in non-normative text at all?

Most of the security section is just explanations of other normative requirements, as well as considerations that can't be formalized as requirements (such as "think about private browsing modes"). I don't think it makes sense to make this section normative.

Instead, I will move that MUST NOT requirement (leaking info about installed apps) into a normative section, and rewrite the security section to be an explanation of those requirements, rather than a statement. There's a similar thing in a NOTE just under the share algorithm which will get the same treatment.

mgiuca added a commit to mgiuca/web-share that referenced this issue Jun 21, 2017
It is now written as an explanation of requirements elsewhere in the
spec.

Closes w3c#40.
mgiuca added a commit to mgiuca/web-share that referenced this issue Jun 21, 2017
It is now written as an explanation of requirements elsewhere in the
spec.

Closes w3c#40.
@domenic
Copy link
Author

domenic commented Jun 21, 2017

I see, so you should not have those keywords in non-normative text at all?

Yeah, it's a bug to state normative requirements in non-normative text. If you're depending on RFC 2119 (either directly, or indirectly via Infra) then any occurrences of those words are to be interpreted as described there, so there's no getting around it.

As you can see from my review of #44 there's a bit of an art to using other phrases (like "can" or "might") instead of these "reserved keywords".

@mgiuca mgiuca closed this as completed in 9e8d108 Jun 23, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants