-
Notifications
You must be signed in to change notification settings - Fork 148
Fix confusing wording wrt adding new features to RECs #1004 #1026
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
base: main
Are you sure you want to change the base?
Conversation
776381b
to
79ea26e
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Minor fix to avoid implying non-normative text.
The new "Such …" sentence I think belongs in a guide (the Guide?), not The Process, and IMO unnecessarily adds length to the Process (which I believe we are trying to continuously shrink and simplify over time).
to a [=Recommendation=] that does not [=allow new features=], | ||
W3C <em class="rfc2119">must</em> create a new [=technical report=], | ||
following the full process of <a href="#rec-advance">advancing a technical report to Recommendation</a> | ||
Note: When a [=Recommendation=] does not [=allow new features=], |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Note: When a [=Recommendation=] does not [=allow new features=], | |
When a [=Recommendation=] does not [=allow new features=], |
Drop "Note: " because in typical W3C contexts it implies a non-normative sentence/paragraph/section, and I don't think that was the intent of this change.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No, that was actually intended. :) This paragraph is identifying an implication of existing normative text.
@tantek I understand what you're getting at, but also this has been a frequent point of confusion, so I think the examples help. But I could be persuaded otherwise depending what others think. CC @nigelmegitt |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the explicit intention of the "Note:".
I still think a Guide patch with examples should be sufficient to help reduce confusion, at least something to try before expanding the Process length. However, I still leave this up to editor discretion.
Addresses #1004
Preview | Diff