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

Retire Proposed Recommendation #868

Open
wants to merge 11 commits into
base: main
Choose a base branch
from
Open

Conversation

frivoal
Copy link
Collaborator

@frivoal frivoal commented May 13, 2024

As discussed in #861, the Proposed Recommendation phase of the REC track exists only to support an AC Review during the transition of a document from CR to REC. We can simplify the Process a good deal by doing away with Proposed Recommendation entirely, and doing the AC Review on the CR that we want to promote to REC. Then, if the AC Review is successful (in addition to the other criteria), we could publish the REC directly.

This Pull Request does just that. It keeps all the criteria that were present at the CR→PR transition, as well those of the PR→REC transition, and combines them into a CR→REC transition.

This allows for a simplification of terminology, a simplification of Process text, a reduction in the number of states described in the REC track diagram, and a reduction of work needed by the WG and the Team (one transition to request instead of two, one less publication to make); all without any changes about what is expected of a Recommendation.


Preview | Diff

Proposed Recommendation is only a transitional phase. Nothing stays
there: either the transition is approved and the spec goes to REC, or
it's not and it reverts to a lower maturity. The things that happen
during PR are useful, but they don't really depend on there being an
explicit phase with an explicit publication, so we can simplify things
by folding all of this into the transition from CR to REC, without a
distinct phase.

Part of w3c#861
@chaals
Copy link
Contributor

chaals commented May 13, 2024

Looks like a good draft (on a skim of the github diff rather than a very careful review, so faar).

Copy link
Member

@TallTed TallTed left a comment

Choose a reason for hiding this comment

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

Editorial language improvements.

index.bs Outdated Show resolved Hide resolved
index.bs Outdated Show resolved Hide resolved
index.bs Outdated Show resolved Hide resolved
index.bs Outdated Show resolved Hide resolved
index.bs Outdated Show resolved Hide resolved
frivoal and others added 5 commits May 14, 2024 13:17
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
@frivoal
Copy link
Collaborator Author

frivoal commented May 14, 2024

Editorial language improvements.

All accepted. Thanks!

@frivoal
Copy link
Collaborator Author

frivoal commented Jun 21, 2024

From the AB's last meeting:

RESOLUTION: The AB is interested in pursuing the retirement of the Proposed Recommendation Phase, and asks the Process CG to work out the details.

@frivoal frivoal added Agenda+ Marks issues that are ready for discussion on the call and removed Needs AB Feedback Advisory Board Input needed labels Jun 21, 2024
@frivoal frivoal marked this pull request as ready for review June 21, 2024 01:25
This is not specifically on the Working Group, so including it in the
list was odd. The requirement itself is unchanged.
Copy link
Contributor

@nigelmegitt nigelmegitt left a comment

Choose a reason for hiding this comment

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

This also made me wonder: can Registries actually include any content that, if changed, would count as a Class 4 change?

Comment on lines +2705 to +2709
For example, to make [=substantive changes=] to a [=technical report=]
prior to publication as a [=Recommendation=],
it would need to go through a new [=Update Request=],
be republished as a new [=Candidate Recommendation=],
and fulfill the criteria for advancement.
Copy link
Contributor

Choose a reason for hiding this comment

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

I find this example quite confusing to read now. I think there may be an unstated assumption that the technical report was a Rec before the substantive changes were made, and the goal is publication as a new Rec version?

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, the assumption is that on a CR to REC transition, the Team cannot just change stuff an publish. Any normative change needs a WG decision, and be published as a CR first (so as to trigger patent exclusion opportunities).

I guess what's confusing here is that "those other conditions must also be re-fulfilled" is in practice not really something you can do in the middle of an AC Review wrap-up, so the realistic way to deal with this is to send the document back for further work, not to approved it with changes integrated (and extra steps to make that possible).

Copy link
Contributor

@nigelmegitt nigelmegitt Jun 28, 2024

Choose a reason for hiding this comment

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

Oh, okay. How about:

Suggested change
For example, to make [=substantive changes=] to a [=technical report=]
prior to publication as a [=Recommendation=],
it would need to go through a new [=Update Request=],
be republished as a new [=Candidate Recommendation=],
and fulfill the criteria for advancement.
For example, if [=substantive changes=] to a [=technical report=]
are requested when assessing the transition from
[=Candidate Recommendation=] to [=Recommendation=],
the technical report would need to go through a new [=Update Request=],
be republished as a new [=Candidate Recommendation=],
and that new version would need to fulfill the criteria for advancement.

Comment on lines -3378 to -3379
<dt>
<dfn export id="RecsPR" lt="W3C Proposed Recommendation | Proposed Recommendation | PR">Proposed Recommendation</dfn> (<abbr>PR</abbr>)
Copy link
Contributor

Choose a reason for hiding this comment

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

Would it be worth keeping a stub definition for this, in case people are looking at old PRs on /history and want to know what they are?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

The id is reserved, so that links will still land in a reasonably relevant place. That place does not mention Proposed Recs explicitly though:
https://github.com/w3c/process/pull/868/files#diff-5e793325cd2bfc452e268a4aa2f02b4024dd9584bd1db3c2595f61f1ecf7b985R3885

I see your point, but at the same time, because Proposed Recs are only an transient state, it's not that common for people to be reading them once the relevant AC Review has closed.

We don't keep a stub definition for Last Call Working Draft either.

Maybe we could add an Appendix to the Process listing all the TR statuses that no longer exist, with pointers to older version of the Process that still had them? Not sure if this would be useful, or just make the Process longer for little benefit.

Copy link
Contributor

Choose a reason for hiding this comment

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

Looking back through /history I see that some SOTDs include a hyperlink from the maturity stage term to its definition in the applicable Process document, e.g. XML1.1 PR but others do not, e.g. HTML5 PR. For those that do not, it would be useful to include this appendix.

Alternatively, the desired changes can be introduced as non-substantive amendments
using the process for [[#revising-rec|revising a Recommendation]].
However, they cannot be directly integrated between [=PR=] and [=REC=],
However, they cannot be directly integrated between [=CRS=] and [=REC=],
Copy link
Contributor

Choose a reason for hiding this comment

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

Except for removal of at-risk features.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

True. However, is that too much detail for an example? We could add it as a parenthetical, but I am not sure if it really brings clarity.

Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think it's too much detail. Without mentioning this, it looks like the example contradicts the Process, and that could be confusing for some group later if they do want to remove at-risk features at this stage.

index.bs Show resolved Hide resolved
index.bs Show resolved Hide resolved
and <em class=rfc2119>must not</em> include any such marking
if not already present.

If all the criteria above are fulfilled,
Copy link
Contributor

Choose a reason for hiding this comment

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

It would be worth being explicit that the Team's trigger to check if the criteria have been fulfilled is a WG Decision to request advancement.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

It's a little hard to see in the diff because there are a lot of added/removed lines in between, but if you look at the built version, isn't that already made clear by the first sentence in the section?
https://pr-preview.s3.amazonaws.com/frivoal/w3process/pull/868.html#transition-rec

Copy link
Contributor

Choose a reason for hiding this comment

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

I did see that sentence, but for myself, I don't think it's clear that a WG requesting advancement to REC is synonymous with a WG Decision to request advancement.

It needs to be unambiguous to Chairs what is required; the alternative is that it could be seen as being okay if a WG has some kind of discussion without a clear assessment of consensus and the Chair then makes a request for advancement on behalf of the WG; that would bypass any WG decision policy, for example.

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 Needs Review Topic: Simplifications
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants