Skip to content

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

fantasai
Copy link
Collaborator

@fantasai fantasai commented Apr 15, 2025

Addresses #1004


Preview | Diff

@fantasai fantasai added the Agenda+ Marks issues that are ready for discussion on the call label Apr 15, 2025
Copy link
Member

@tantek tantek left a 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=],
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Copy link
Collaborator Author

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.

@fantasai
Copy link
Collaborator Author

@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

Copy link
Member

@tantek tantek left a 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Agenda+ Marks issues that are ready for discussion on the call
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants