Skip to content

Commit d4d40d7

Browse files
frivoalTallTed
andauthored
Make it so that all RECs can gain new features & simplify terminology accordingly (#1168)
* Allow new features in all Recommendations Remove the opt-in distinction between Recommendations that "allow new features" and those that don't, so that we may have a single type of Recommendations. The distinction and the related procedural steps were a frequent source of confusion. Part of addressing w3c/AB-memberonly#244 * Stop distinguishing between different types of Last Call for Review This these are now proceduraly interchangeable and valid in the same situations, formal distinction is no longer necessary. Informal descriptions of the nature of the changes remain possible, but are no longer mandated by the Process. Part of addressing w3c/AB-memberonly#244 * Stop distinguishing different types of candidate/proposed amendments Part of addressing w3c/AB-memberonly#244 * Fix typo Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com> * Phrasing tweak Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com> --------- Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
1 parent 10b07bc commit d4d40d7

1 file changed

Lines changed: 64 additions & 76 deletions

File tree

index.bs

Lines changed: 64 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -3365,17 +3365,21 @@ Errata Management</h4>
33653365
be annotated inline
33663366
alongside the affected [=technical report=] text
33673367
or at the start or end of the most relevant section(s).
3368+
Inline errata are treated as <a href="#class-2">class 2 changes</a>,
3369+
and are published accordingly.
3370+
3371+
An [=erratum=] <em class="rfc2119">may</em> be accompanied by a
3372+
[=candidate amendment=] proposing a solution to the issue.
33683373

33693374
<h4 id=candidate-amendments oldids=candidate-changes>
33703375
Candidate Amendments</h4>
33713376

3372-
An [=erratum=] <em class="rfc2119">may</em> be accompanied by a non-normative,
3373-
<dfn>candidate correction</dfn> approved by [=group decision=].
3374-
When annotated inline,
3375-
errata--
3376-
including their [=candidate corrections=]--
3377-
must be marked as such,
3378-
are treated as <a href="#correction-classes">class 2 changes</a>,
3377+
A <dfn>candidate amendment</dfn> is a non-normative annotation,
3378+
marked as such,
3379+
integrated into a [=technical report=] by [=group decision=]
3380+
to indicate a potential [=substantive change=]
3381+
that has not yet been formally adopted.
3382+
They are treated as <a href="#class-2">class 2 changes</a>,
33793383
and are published accordingly.
33803384

33813385
Note: Annotating changes in this way allows more mature documents
@@ -3385,13 +3389,6 @@ Candidate Amendments</h4>
33853389
sufficient review or implementation experience
33863390
to be normatively incorporated into the specification proper.
33873391

3388-
A <dfn>candidate addition</dfn> is similar to a [=candidate correction=],
3389-
except that it proposes a new feature
3390-
rather than an error correction.
3391-
3392-
[=Candidate corrections=] and [=candidate additions=] are collectively known as
3393-
<dfn lt="candidate amendment">candidate amendments</dfn>.
3394-
33953392
In addition to their actual [[#maturity-stages|maturity stage]],
33963393
[=published=] [=REC Track=] documents with [=candidate amendments=] are also considered,
33973394
for the purpose of the W3C Patent Policy [[PATENT-POLICY]],
@@ -3408,7 +3405,7 @@ Maintenance Without a Group</h4>
34083405
<ol>
34093406
<li><a href="#class-1">class 1 changes</a>;
34103407
<li>inline [=errata=];
3411-
<li>[=candidate corrections=],
3408+
<li>[=candidate amendments=] not including <a href="#class-4">class 4 changes</a>,
34123409
which <em class=rfc2119>must</em> be marked as <dfn>Team correction</dfn>;
34133410
<li><a href="#class-2">class 2 changes</a> other than inline [=errata=] and [=Team corrections=].
34143411
</ol>
@@ -3637,15 +3634,6 @@ Maturity Stages on the Recommendation Track</h4>
36373634
(in accordance with [[#revising-rec]])
36383635
to address [=editorial change|editorial=] or [=substantive change|substantive=] issues
36393636
that are discovered later.
3640-
However, <a href=#class-4>new features</a> can only be added
3641-
if the document already identifies itself
3642-
as intending to <dfn>allow new features</dfn>.
3643-
Adding or removing this allowance is a [=substantive change=].
3644-
Such an allowance cannot be added
3645-
to a [=technical report=] previously published as a [=Recommendation=]
3646-
that did not allow such changes;
3647-
this requires a new [=technical report=]
3648-
(which could, for example, be similarly named but with an incremented version number).
36493637

36503638
As technology evolves,
36513639
a [=W3C Recommendation=] may become:
@@ -4163,20 +4151,10 @@ Requirements for Transition</h5>
41634151
<em class="rfc2119">must</em> identify, in the document, where errata are tracked.
41644152
</ul>
41654153

4166-
Additionally,
4167-
if the document has previously been published as a [=W3C Recommendation=], the [=Working Group=]
4168-
<em class=rfc2119>must not</em> include any <a href="#correction-classes">class 4 change</a>
4169-
to that publication
4170-
unless it was explicitly marked as [=allowing new features=],
4171-
and <em class=rfc2119>must not</em> include any such marking
4172-
if not already present.
4173-
41744154
If the document's most recent publication is a [=Candidate Recommendation Draft=],
41754155
the [=Team=] <em class=rfc2119>must</em> verify
41764156
that it contains no changes since the previous [=Candidate Recommendation Snapshot=] other than:
41774157
* [=editorial changes=],
4178-
* the addition or removal of a statement as to whether the document will [=allow new features=]
4179-
after its publication as a [=Recommendation=].
41804158
* dropping [=at risk=] features
41814159

41824160
Otherwise, the [=Working Group=] <em class=rfc2119>must</em> republish it
@@ -4257,18 +4235,19 @@ Revising a Recommendation: Editorial Changes</h5>
42574235
to make this class of change without passing through earlier maturity stages.
42584236
(See <a href="#class-1">class 1</a> and <a href="#class-2">class 2 changes</a>.)
42594237

4260-
<h5 id="revised-rec-substantive">
4238+
<h5 id="revised-rec-substantive" oldids="revised-rec-features">
42614239
Revising a Recommendation: Substantive Changes</h5>
42624240

4263-
Tentative corrections (see <a href="#class-3">class 3 changes</a>)
4241+
Tentative [=substantive changes=]
4242+
(see <a href="#class-3">class 3</a> and <a href="#class-4">class 4 changes</a>.)
42644243
<em class=rfc2119>may</em> be annotated into a [=Recommendation=]
4265-
using [=candidate corrections=].
4244+
using [=candidate amendments=].
42664245

4267-
Note: [=Candidate corrections=] do not normatively modify the document;
4246+
Note: [=Candidate amendments=] do not normatively modify the document;
42684247
they editorially indicate how one might do so.
42694248
They are therefore published following the provisions of [[#revised-rec-editorial]].
42704249

4271-
A [=candidate correction=] can be made normative
4250+
A [=candidate amendment=] can be made normative
42724251
and be folded into the main text of the [=Recommendation=],
42734252
once it has satisfied all the same criteria
42744253
as the rest of the [=Recommendation=],
@@ -4285,30 +4264,19 @@ Revising a Recommendation: Substantive Changes</h5>
42854264
or, if the relevant criteria are fulfilled,
42864265
<a href="#transition-cr">publish as a Candidate Recommendation</a>--
42874266
and advance the specification from that state.
4288-
(See <a href="#correction-classes">class 3 changes</a>.)
4289-
4290-
<h5 id="revised-rec-features">
4291-
Revising a Recommendation: New Features</h5>
4292-
4293-
For [=Recommendations=] explicitly identified as [=allow new features|allowing new features=],
4294-
tentative new features (see <a href="#correction-classes">class 4 changes</a>)
4295-
<em class=rfc2119>may</em> be added as [=candidate additions=] in annotations,
4296-
and <a href="#correction-classes">class 4 changes</a> may be normatively incorporated
4297-
in the same fashion as <a href="#correction-classes">class 3 changes</a> in [[#revised-rec-substantive]].
4298-
4299-
Note: Limiting the addition of new features to [=Recommendations=] that explicitly allow them
4300-
enables third parties to depend on a stable feature-set for [=Recommendations=] that do not advertise that ability,
4301-
as was the case for all [=Recommendations=] prior to the 2020 revision of this Process.
4302-
4303-
Note: When a [=Recommendation=] does not [=allow new features=],
4304-
new features can be added by creating a new [=technical report=]
4305-
and following the full process of advancing that [=technical report=] to [=Recommendation=]--
4306-
beginning with a new [=First Public Working Draft=].
4307-
Such [=technical reports=] could be written to represent
4308-
additional modules building on top of the original [=Recommendation=] of the core technology,
4309-
or an expanded replacement of the original [=Recommendation=] of the core technology
4310-
(in which case the new [=technical report=] will typically have the same name as the original,
4311-
with an incremented version number).
4267+
4268+
<div id=allow-features-note class=note>
4269+
<span class=marker>Note:</span>
4270+
In earlier version of the Process,
4271+
new features (<a href="#class-4">class 4 changes</a>) could only be added to [=Recommendations=]
4272+
that had explicitly opted into this ability
4273+
prior to their first publication as [=Recommendation=].
4274+
Otherwise,
4275+
new features could only be added by creating a new [=technical report=]
4276+
and following the full process of advancing that [=technical report=] to [=Recommendation=]--
4277+
beginning with a new [=First Public Working Draft=].
4278+
For simplicity, this restriction has been lifted.
4279+
</div>
43124280

43134281
<h5 id=change-review>
43144282
Incorporating Candidate Amendments</h5>
@@ -4321,16 +4289,9 @@ Incorporating Candidate Amendments</h5>
43214289
must be announced to other W3C groups, the public, and the [=Advisory Committee=].
43224290
The announcement <em class="rfc2119">must</em>:
43234291
<ul>
4324-
<li>
4325-
Identify whether this is a
4326-
<dfn>Last Call for Review of Proposed Corrections</dfn>,
4327-
<dfn>Last Call for Review of Proposed Additions</dfn>,
4328-
or <dfn>Last Call for Review of Proposed Corrections and Additions</dfn>.
4329-
43304292
<li>
43314293
Identify the specific [=candidate amendments=] under review
4332-
as <dfn>proposed amendments</dfn>
4333-
(<dfn export>proposed corrections</dfn>/<dfn oldids="proposed-addition" export>proposed additions</dfn>).
4294+
as <dfn>proposed amendments</dfn>.
43344295

43354296
<li>
43364297
Specify the deadline for review comments,
@@ -4347,10 +4308,6 @@ Incorporating Candidate Amendments</h5>
43474308
Also, the review initiated by the [=Last Call for Review of Proposed Amendments=]
43484309
is an [=Advisory Committee Review=].
43494310

4350-
Note: [=Last Call for Review of Proposed Additions=] and
4351-
[=Last Call for Review of Proposed Corrections and Additions=]
4352-
can only be issued for [=Recommendations=] that [=allow new features=].
4353-
43544311
A [=Working Group=] <em class="rfc2119">may</em> batch
43554312
multiple [=proposed amendments=] into a single <a>Last Call for Review of Proposed Amendments</a>.
43564313
To facilitate review,
@@ -4704,7 +4661,7 @@ Revising W3C Statements</h4>
47044661
an [=Advisory Committee review=] of the changes it wishes to incorporate.
47054662
The specific [=candidate amendments=] under review
47064663
<em class=rfc2119>must</em> be identified as [=proposed amendments=]
4707-
just as in a [=Last Call for Review of Proposed Corrections=].
4664+
just as in a [=Last Call for Review of Proposed Amendments=].
47084665

47094666
The decision to incorporate [=proposed amendments=] into [=W3C Statement=] is a [=W3C Decision=].
47104667
[=Advisory Committee representatives=] may initiate an [=Advisory Committee Appeal=] of the decision.
@@ -5471,6 +5428,37 @@ Appendix A: Retired Terminology</h2>
54715428
<dd>
54725429
Last defined <a href="https://www.w3.org/2014/Process-20140801/#def-W3CChair">in section 2.2 of the 2014 Process</a>,
54735430
now called [=CEO=].
5431+
5432+
<dt>
5433+
<dfn noexport>Allow new features</dfn>
5434+
(retired term)
5435+
<dd>
5436+
Last defined <a href="https://www.w3.org/policies/process/20250818/#allow-new-features">in section 6.3.1 of the 2025 Process</a>.
5437+
See also <a href="#allow-features-note">the note</a> at the end of [[#revised-rec-substantive]].
5438+
5439+
<dt>
5440+
<dfn noexport>Candidate correction</dfn> and <dfn noexport>candidate addition</dfn>
5441+
(retired terms)
5442+
<dd>
5443+
Last defined in <a href="https://www.w3.org/policies/process/20250818/#candidate-amendments">section 6.2.5 of the 2025 Process</a>.
5444+
Both were subtypes of [=candidate amendment=] and are no longer formally distinguished.
5445+
5446+
<dt>
5447+
<dfn noexport>Proposed corrections</dfn> and <dfn oldids="proposed-addition" export>proposed additions</dfn>
5448+
(retired terms)
5449+
<dd>
5450+
Last defined in <a href="https://www.w3.org/policies/process/20250818/#change-review">section 6.3.10.4 of the 2025 Process</a>.
5451+
Both were subtypes of [=proposed amendment=] and are no longer formally distinguished.
5452+
5453+
<dt>
5454+
<dfn noexport>Last Call for Review of Proposed Corrections</dfn>,
5455+
<dfn noexport>Last Call for Review of Proposed Additions</dfn>, and
5456+
<dfn noexport>Last Call for Review of Proposed Corrections and Additions</dfn>
5457+
(retired terms)
5458+
<dd>
5459+
Last defined in <a href="https://www.w3.org/policies/process/20250818/#change-review">section 6.3.10.4 of the 2025 Process</a>.
5460+
All were subtypes of [=Last Call for Review of Proposed Amendments=],
5461+
and are no longer formally distinguished.
54745462
</dl>
54755463

54765464
<h2 id="acks" class="non-normative nonum">

0 commit comments

Comments
 (0)