Skip to content

Commit

Permalink
[Editorial] Give context for candidate amendments when revising a REC
Browse files Browse the repository at this point in the history
This change gives a little bit more context about how to make normative
changes to a REC. Technically, and this is what the existing text talked
about, they are made by folding in candidate amendments. However,
someone just reading that section may not be aware of what candidate
amendments are and how they are made to begin with.

This gives just a little bit of context to help people piece things
together.

This is a small step towards addressing w3c#700
  • Loading branch information
frivoal committed May 1, 2024
1 parent 73e4446 commit 59e64a5
Showing 1 changed file with 17 additions and 4 deletions.
21 changes: 17 additions & 4 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -4045,12 +4045,20 @@ Revising a Recommendation: Editorial Changes</h5>
<h5 id="revised-rec-substantive">
Revising a Recommendation: Substantive Changes</h5>

Tentative corrections (see <a href="#class-3">class 3 changes</a>)
<em class=rfc2119>may</em> be annotated into a [=Recommendation=]
using [=candidate corrections=].

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

A [=candidate correction=] can be made normative
and be folded into the main text of the [=Recommendation=],
once it has satisfied all the same criteria
as the rest of the [=Recommendation=],
including review by the community to ensure
the technical and editorial soundness of the [=candidate amendments=].
the technical and editorial soundness.
To validate this, the [=Working Group=] must request
a [=Last Call for Review of Proposed Amendments=],
followed by an [=update request=].
Expand All @@ -4073,13 +4081,18 @@ Revising a Recommendation: Substantive Changes</h5>
<h5 id="revised-rec-features">
Revising a Recommendation: New Features</h5>

New features (see <a href="#correction-classes">class 4 changes</a>)
may be incorporated into a [=Recommendation=]
Tentative new features (see <a href="#correction-classes">class 4 changes</a>)
<em class=rfc2119>may</em> be annotated into a [=Recommendation=]
explicitly identified as [=allow new features|allowing new features=]
using [=candidate additions=].

Note: [=Candidate additions=] do not normatively modify the document;
they editorially indicate how one might do so.
They are therefore be published following the provisions of [[#revised-rec-editorial]].

A [=candidate addition=] can be made normative
and be folded into the main text of the [=Recommendation=]
using the same process as for [=candidate amendments=],
using the same process as for [=candidate corrections=],
as detailed in [[#revised-rec-substantive]].

Note: This prohibition against new features unless explicitly allowed
Expand Down

0 comments on commit 59e64a5

Please sign in to comment.