From bc0a5b58f10cc0c6db8614ee1cc8b31940cd1ae9 Mon Sep 17 00:00:00 2001 From: Denis Ah-Kang Date: Fri, 25 Jul 2025 10:40:19 +0400 Subject: [PATCH 1/6] new process document --- lib/l10n-en_GB.js | 4 +- lib/rules.json | 70 ++++++++++---------- lib/rules/metadata/process.js | 6 +- lib/rules/sotd/new-features.js | 10 +-- lib/rules/sotd/process-document.js | 13 ++-- lib/rules/sotd/publish.js | 2 +- lib/rules/sotd/stability.js | 6 +- test/doc-views/TR/Recommendation/REC.js | 2 +- test/doc-views/TR/TRBase.js | 4 +- test/doc-views/layout/spec.handlebars | 6 +- test/doc-views/partials/stability.handlebars | 4 +- test/doc-views/specBase.js | 8 +-- test/docs/2021-cr.html | 6 +- test/docs/2021-crd.html | 4 +- test/docs/2021-cry.html | 6 +- test/docs/2021-cryd.html | 4 +- test/docs/2021-disc.html | 4 +- test/docs/2021-dnote.html | 4 +- test/docs/2021-dry.html | 4 +- test/docs/2021-fpwd.html | 4 +- test/docs/2021-note.html | 4 +- test/docs/2021-pr.html | 4 +- test/docs/2021-rec.html | 2 +- test/docs/2021-ry.html | 4 +- test/docs/2021-stmt.html | 4 +- test/docs/2021-wd-shortname-change.html | 4 +- test/docs/2021-wd.html | 4 +- test/samples.js | 28 ++++---- 28 files changed, 106 insertions(+), 119 deletions(-) diff --git a/lib/l10n-en_GB.js b/lib/l10n-en_GB.js index 26fb26d81..1e5a778ef 100644 --- a/lib/l10n-en_GB.js +++ b/lib/l10n-en_GB.js @@ -186,7 +186,7 @@ export const messages = { 'sotd.stability.no-cr-review': 'No wide review link for Candidate Recommendation', 'sotd.stability.wrong-cr-review-link': - "Wrong wide review link for Candidate Recommendation, link should be 'https://www.w3.org/policies/process/20231103/#dfn-wide-review'", + "Wrong wide review link for Candidate Recommendation, link should be 'https://www.w3.org/policies/process/202508XX/#dfn-wide-review'", 'sotd.stability.no-licensing-link': "Wrong royalty-free licensing link for CR and REC, link should be ${licensingLink} with text '${licensingText}'", // sotd/review-end @@ -278,7 +278,7 @@ export const messages = { 'Deliverer not found. An attribute data-deliverer must be in the SotD', // sotd/new-features 'sotd.new-features.no-link': - 'The paragraph on future updates to the recommendation should include a link to the new features: https://www.w3.org/policies/process/20231103/#allow-new-features', + 'The paragraph on future updates to the recommendation should include a link to the new features: https://www.w3.org/policies/process/202508XX/#allow-new-features', 'sotd.new-features.no-warning': "If it is the intention to incorporate new features in future updates of the Recommendation, please make sure to identify the document as intending to allow new features.", // structure/canonical diff --git a/lib/rules.json b/lib/rules.json index 2260ef711..e02066a39 100644 --- a/lib/rules.json +++ b/lib/rules.json @@ -146,8 +146,8 @@ "datesFormat": true, "publish": [ "Draft Registry", - "Registry track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Registry track</a>" + "Registry track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Registry track</a>" ], "customParagraph": true, "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Draft Registry does not imply endorsement by W3C and its Members

", @@ -235,11 +235,11 @@ "datesFormat": true, "publish": [ "Candidate Registry Snapshot", - "Registry track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Registry track</a>" + "Registry track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Registry track</a>" ], "customParagraph": true, - "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Draft Registry does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received wide review.

Include this source code:
<p>Publication as a Draft Registry does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received <a href=\"https://www.w3.org/policies/process/20231103/#dfn-wide-review\">wide review</a>.</p>
", + "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Draft Registry does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received wide review.

Include this source code:
<p>Publication as a Draft Registry does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received <a href=\"https://www.w3.org/policies/process/202508XX/#dfn-wide-review\">wide review</a>.</p>
", "reviewEndDate": "It must include a minimal duration (before which the group will not request the next transition). The duration must be expressed as an estimated date.", "knownDisclosureNumber": true, "patPolReq": true, @@ -324,8 +324,8 @@ "datesFormat": true, "publish": [ "Candidate Registry Draft", - "Registry track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Registry track</a>" + "Registry track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Registry track</a>" ], "customParagraph": true, "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Candidate Registry Draft does not imply endorsement by W3C and its Members. A Candidate Registry Draft integrates changes from the previous Candidate Registry that the Working Group intends to include in a subsequent Candidate Registry Snapshot.

", @@ -413,8 +413,8 @@ "datesFormat": true, "publish": [ "Registry", - "Registry track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Registry track</a>" + "Registry track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Registry track</a>" ], "customParagraph": true, "usage": "It must include the expectations in terms of usage of this registry. The SOTD should include the paragraph:
W3C recommends the wide usage of this registry.
", @@ -507,8 +507,8 @@ "boilerplateTRDoc": true, "publish": [ "Group Draft Note", - "Note track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Note track</a>" + "Note track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Note track</a>" ], "customParagraph": true, "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Group Draft Notes are not endorsed by W3C nor its Members.

or

This Group Draft Note is endorsed by the @@@ Working/Interest Group (and the @@@ Working/Interest Group), but is not endorsed by W3C itself nor its Members.

", @@ -596,8 +596,8 @@ "datesFormat": true, "publish": [ "Group Note", - "Note track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Note track</a>" + "Note track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Note track</a>" ], "customParagraph": true, "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Group Notes are not endorsed by W3C nor its Members.

or

This Group Note is endorsed by the @@@ Working/Interest Group (and the @@@ Working/Interest Group), but is not endorsed by W3C itself nor its Members.

", @@ -685,8 +685,8 @@ "datesFormat": true, "publish": [ "Statement", - "Note track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Note track</a>" + "Note track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Note track</a>" ], "customParagraph": true, "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

A W3C Statement is a specification that, after extensive consensus-building, is endorsed by W3C and its Members.

Include this source code:
<p>A W3C Statement is a specification that, after extensive consensus-building, is endorsed by W3C and its Members.</p>
", @@ -778,8 +778,8 @@ "datesFormat": true, "publish": [ "First Public Working Draft", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "customParagraph": true, "stability": ["a First Public Working Draft", ""], @@ -866,8 +866,8 @@ "datesFormat": true, "publish": [ "Working Draft", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "customParagraph": true, "changesList": ["should", ""], @@ -960,15 +960,15 @@ "datesFormat": true, "publish": [ "Candidate Recommendation Snapshot", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "reviewEndDate": "It must include a minimal duration (before which the group will not request the next transition). The duration must be expressed as an estimated date.", "implEstimation": "It should include an estimated date by which time the Working Group expects to have sufficient implementation experience.", "featAtRisk": "It must identify any \"features at risk\" declared by the Working Group (as defined in section 6.4 of the W3C Process Document).", "customParagraph": true, "changesList": ["must", ""], - "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received wide review, is intended to gather implementation experience, and has commitments from Working Group members to royalty-free licensing for implementations.

Include this source code:
<p>Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received <a href=\"https://www.w3.org/policies/process/20231103/#dfn-wide-review\">wide review</a>, is intended to gather implementation experience, and has commitments from Working Group members to <a href=\"https://www.w3.org/policies/patent-policy/#sec-Requirements\">royalty-free licensing</a> for implementations.</p>
", + "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received wide review, is intended to gather implementation experience, and has commitments from Working Group members to royalty-free licensing for implementations.

Include this source code:
<p>Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received <a href=\"https://www.w3.org/policies/process/202508XX/#dfn-wide-review\">wide review</a>, is intended to gather implementation experience, and has commitments from Working Group members to <a href=\"https://www.w3.org/policies/patent-policy/#sec-Requirements\">royalty-free licensing</a> for implementations.</p>
", "patPolReq": true, "knownDisclosureNumber": true, "whichProcess": true @@ -1053,8 +1053,8 @@ "datesFormat": true, "publish": [ "Candidate Recommendation Draft", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "reviewEndDate": "It must include a minimal duration (before which the group will not request the next transition). The duration must be expressed as an estimated date.", "implEstimation": "It should include an estimated date by which time the Working Group expects to have sufficient implementation experience.", @@ -1147,8 +1147,8 @@ "datesFormat": true, "publish": [ "Proposed Recommendation", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "ACRepFeedbackEmail": true, "reviewEndDatePR": true, @@ -1162,7 +1162,7 @@ "draftStability": true, "patPolReq": true, "knownDisclosureNumber": true, - "newFeatures": "If it is the intention to incorporate new features in future updates of the specification, please make sure to identify the document as intending to allow new features. Recommended text is:
Future updates to this specification may incorporate new features.
Include one of this source code:
<p>Future updates to this specification may incorporate <a href=\"https://www.w3.org/policies/process/20231103/#allow-new-features\">new features</a>.</p>", + "newFeatures": "If it is the intention to incorporate new features in future updates of the specification, please make sure to identify the document as intending to allow new features. Recommended text is:
Future updates to this specification may incorporate new features.
Include one of this source code:
<p>Future updates to this specification may incorporate <a href=\"https://www.w3.org/policies/process/202508XX/#allow-new-features\">new features</a>.</p>", "whichProcess": true } }, @@ -1250,14 +1250,14 @@ "boilerplateTRDoc": true, "datesFormat": true, "deployment": true, - "publish": "W3C Recommendation must include one of the following paragraphs in the \"Status of This Document\" depending on the type of Recommendations:
  1. Recommendation without modifications:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>.</p>
  2. Recommendation with candidate corrections:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes candidate corrections.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/20231103/#candidate-correction\">candidate corrections.</a>.</p>
  3. Recommendation with candidate additions:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes candidate additions, introducing new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/20231103/#candidate-addition\">candidate additions</a>, introducing new features since the Previous Recommendation.</p>
  4. Recommendation with candidate amendments:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes candidate amendments, introducing substantive changes and new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/20231103/#candidate-amendments\">candidate amendments</a>, introducing substantive changes and new features since the Previous Recommendation.</p>
  5. Recommendation with proposed corrections:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes proposed corrections.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/20231103/#proposed-corrections\">proposed corrections.</a>.</p>
  6. Recommendation with proposed additions:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes proposed additions, introducing new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/20231103/#proposed-addition\">proposed additions</a>, introducing new features since the Previous Recommendation.</p>
  7. Recommendation with proposed amendments:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes proposed amendments, introducing substantive changes and new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/20231103/#proposed-amendments\">proposed amendments</a>, introducing substantive changes and new features since the Previous Recommendation.</p>
", + "publish": "W3C Recommendation must include one of the following paragraphs in the \"Status of This Document\" depending on the type of Recommendations:
  1. Recommendation without modifications:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>.</p>
  2. Recommendation with candidate corrections:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes candidate corrections.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/202508XX/#candidate-correction\">candidate corrections.</a>.</p>
  3. Recommendation with candidate additions:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes candidate additions, introducing new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/202508XX/#candidate-addition\">candidate additions</a>, introducing new features since the Previous Recommendation.</p>
  4. Recommendation with candidate amendments:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes candidate amendments, introducing substantive changes and new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/202508XX/#candidate-amendments\">candidate amendments</a>, introducing substantive changes and new features since the Previous Recommendation.</p>
  5. Recommendation with proposed corrections:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes proposed corrections.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/202508XX/#proposed-corrections\">proposed corrections.</a>.</p>
  6. Recommendation with proposed additions:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes proposed additions, introducing new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/202508XX/#proposed-addition\">proposed additions</a>, introducing new features since the Previous Recommendation.</p>
  7. Recommendation with proposed amendments:
    This document was published by the @@ Working Group as a Recommendation using the Recommendation track. It includes proposed amendments, introducing substantive changes and new features since the Previous Recommendation.
    Include this source code:
    <p>This document was published by the @@ Working Group as a Recommendation using the <a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>. It includes <a href=\"https://www.w3.org/policies/process/202508XX/#proposed-amendments\">proposed amendments</a>, introducing substantive changes and new features since the Previous Recommendation.</p>
", "recRelation": "It must indicate its relationship to previous related Recommendations (e.g., an indication that a Recommendation supersedes, obsoletes, or subsumes another, or that a Recommendation is an editorial revision) and must link to the most recent Recommendation (if any) having the same major revision number. The document thus links to two important resources: the previous edition of the Recommendation via the status section, and the previous draft (the Proposed Recommendation) via the \"Previous version\" link.", "customParagraph": true, "changesList": ["must", ""], "stability": "It must set expectations about the stability of the document. The recommended text is:

A W3C Recommendation is a specification that, after extensive consensus-building, is endorsed by W3C and its Members, and has commitments from Working Group members to royalty-free licensing for implementations.

Include this source code:
<p>A W3C Recommendation is a specification that, after extensive consensus-building, is endorsed by <abbr title=\"World Wide Web Consortium\">W3C</abbr> and its Members, and has commitments from Working Group members to <a href=\"https://www.w3.org/policies/patent-policy/#sec-Requirements\">royalty-free licensing</a> for implementations.</p>
", "patPolReq": true, "knownDisclosureNumber": true, - "newFeatures": "If it is the intention to incorporate new features in future updates of the Recommendation, please make sure to identify the document as intending to allow new features. Recommended text is:
Future updates to this Recommendation may incorporate new features.
Include one of this source code:
<p>Future updates to this Recommendation may incorporate <a href=\"https://www.w3.org/policies/process/20231103/#allow-new-features\">new features</a>.</p>", + "newFeatures": "If it is the intention to incorporate new features in future updates of the Recommendation, please make sure to identify the document as intending to allow new features. Recommended text is:
Future updates to this Recommendation may incorporate new features.
Include one of this source code:
<p>Future updates to this Recommendation may incorporate <a href=\"https://www.w3.org/policies/process/202508XX/#allow-new-features\">new features</a>.</p>", "whichProcess": true, "recAddition": "Modifications in W3C Recommendation are divided into \"new features\" and \"changes\". Recommendations with modifications must include the following paragraphs depending on the changes.
  1. proposed corrections, aka \"substantive changes\":

    there should be a paragraph with class=\"correction proposed\"

    Proposed corrections are marked in the document.
    Include this source code:
    <p class=\"correction proposed\">Proposed corrections are marked in the document.</p>
  2. proposed additions, aka \"new features\":

    there should be a paragraph with class=\"addition proposed\"

    Proposed additions are marked in the document.
    Include this source code:
    <p class=\"addition proposed\">Proposed additions are marked in the document.</p>
  3. candidate corrections, aka \"substantive changes\":

    there should be a paragraph with class=\"correction\"

    Candidate corrections are marked in the document.
    Include this source code:
    <p class=\"correction\">Candidate corrections are marked in the document.</p>
  4. candidate additions, aka \"new features\":

    there should be a paragraph with class=\"addition\"

    Candidate additions are marked in the document.
    Include this source code:
    <p class=\"correction\">Candidate additions are marked in the document.</p>
", "commentEnd": "W3C Recommendation with proposed amendments (substantive changes or new features) must have a comment review date of at least 60 days after the publication date." @@ -1342,8 +1342,8 @@ "datesFormat": true, "publish": [ "Recommendation", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "recRelation": true, "rescindsRationale": "It must include rationale for the decision to rescind the Recommendation.

Include this source code:
<p>W3C has chosen to rescind the <a href=\"@@PREVIOUS REC URI@@\">@@TITLE@@ Recommendation</a> for the following reasons: [...list of reasons...]. For additional information about replacement or alternative technologies, please refer to the <a href=\"https://www.w3.org/2016/11/obsoleting-rescinding/\">explanation of Obsoleting, Rescinding or Superseding W3C Specifications</a>.</p>

", @@ -1430,8 +1430,8 @@ "datesFormat": true, "publish": [ "Discontinued Draft", - "Recommendation track", - "<a href=\"https://www.w3.org/policies/process/20231103/#recs-and-notes\">Recommendation track</a>" + "Recommendation track", + "<a href=\"https://www.w3.org/policies/process/202508XX/#recs-and-notes\">Recommendation track</a>" ], "stability": "It must set expectations about the (in)stability of the document. The recommended text is:

Publication as a Discontinued Draft implies that this document is no longer intended to advance or to be maintained. It is inappropriate to cite this document as other than abandoned work.

Include this source code:
<p>Publication as a Discontinued Draft implies that this document is no longer intended to advance or to be maintained. It is inappropriate to cite this document as other than abandoned work.</p>
", "patPolReq": true, @@ -1525,7 +1525,7 @@ "draftStability": "It must include the following sentences in the \"Status Of This Document\":
This is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to cite this document as other than a work in progress.
", "patPolReq": "It must include a text related to the patent policy:", "knownDisclosureNumber": "It must not indicate the number of known disclosures at the time of publication.", - "whichProcess": "The document must include the following boilerplate text in the status section to identify the governing process:

This document is governed by the 03 November 2023 W3C Process Document.

Include this source code:
<p>This document is governed by the <a id=\"w3c_process_revision\" href=\"https://www.w3.org/policies/process/20231103/\">03 November 2023 W3C Process Document</a>. </p>
", + "whichProcess": "The document must include the following boilerplate text in the status section to identify the governing process:

This document is governed by the 03 November 2023 W3C Process Document.

Include this source code:
<p>This document is governed by the <a id=\"w3c_process_revision\" href=\"https://www.w3.org/policies/process/202508XX/\">03 November 2023 W3C Process Document</a>. </p>
", "discontinue": "If the document was published due to a W3C decision to stop work on this material, the status section should include that rationale.", "expectations": "It should indicate the level of endorsement within the group for the material, set expectations that the group has completed work on the topics covered by the document, and set expectations about the group's commitment to respond to comments about the document.", "ACRepFeedbackEmail": "It also must provide information to Advisory Committee Representatives about how to send their review comments (e.g., the link to all AC reviews, or a link to a specific questionnaire)", @@ -1587,7 +1587,7 @@ "rec-edit-sotd": { "name": "6. Change the \"status of this document\" section", "rules": { - "sotd": "The SOTD gets updated as follows:" + "sotd": "The SOTD gets updated as follows:" } } } diff --git a/lib/rules/metadata/process.js b/lib/rules/metadata/process.js index 7c5a2bbbd..a73564bef 100644 --- a/lib/rules/metadata/process.js +++ b/lib/rules/metadata/process.js @@ -23,9 +23,5 @@ export function check(sr, done) { if (!processDocumentHref) { return done(); } - const process = - processDocumentHref === 'https://www.w3.org/2023/Process-20231103/' - ? 'https://www.w3.org/policies/process/20231103/' - : processDocumentHref; - return done({ process }); + return done({ process: processDocumentHref }); } diff --git a/lib/rules/sotd/new-features.js b/lib/rules/sotd/new-features.js index 6b883e9de..23099c4bb 100644 --- a/lib/rules/sotd/new-features.js +++ b/lib/rules/sotd/new-features.js @@ -18,17 +18,13 @@ export function check(sr, done) { `Future updates to this ${docType} may incorporate new features.` ); const linkTxt = 'new features'; - const linkHrefOld = - 'https://www.w3.org/2023/Process-20231103/#allow-new-features'; - const linkHrefNew = - 'https://www.w3.org/policies/process/20231103/#allow-new-features'; + const linkHref = + 'https://www.w3.org/policies/process/202508XX/#allow-new-features'; if (sotd && sr.norm(sotd.textContent).match(warning)) { const foundLink = Array.prototype.some.call( sotd.querySelectorAll('a'), - a => - sr.norm(a.textContent) === linkTxt && - [linkHrefNew, linkHrefOld].includes(a.href) + a => sr.norm(a.textContent) === linkTxt && a.href === linkHref ); if (!foundLink) { sr.error(self, 'no-link'); diff --git a/lib/rules/sotd/process-document.js b/lib/rules/sotd/process-document.js index fd5f22430..f693b65ba 100644 --- a/lib/rules/sotd/process-document.js +++ b/lib/rules/sotd/process-document.js @@ -14,11 +14,10 @@ export function check(sr, done) { const sotd = sr.getSotDSection(); const BOILERPLATE_PREFIX = 'This document is governed by the '; const BOILERPLATE_SUFFIX = ' W3C Process Document.'; - const newProc = '03 November 2023'; - const newProcOldUri = 'https://www.w3.org/2023/Process-20231103/'; - const newProcNewUri = 'https://www.w3.org/policies/process/20231103/'; - const previousProc = '12 June 2023'; - const previousProcUri = 'https://www.w3.org/2023/Process-20230612/'; + const newProc = 'XX August 2025'; + const newProcUri = 'https://www.w3.org/policies/process/202508XX/'; + const previousProc = '03 November 2023'; + const previousProcUri = 'https://www.w3.org/policies/process/20231103/'; let previousAllowed; const boilerplate = BOILERPLATE_PREFIX + newProc + BOILERPLATE_SUFFIX; @@ -45,9 +44,7 @@ export function check(sr, done) { if ( sr.norm(p.textContent) === boilerplate && link && - [newProcOldUri, newProcNewUri].includes( - link.getAttribute('href') - ) + newProcUri === link.getAttribute('href') ) { if (found) sr.error(self, 'multiple-times', { process: newProc }); diff --git a/lib/rules/sotd/publish.js b/lib/rules/sotd/publish.js index 3cfe79564..38da3cebc 100644 --- a/lib/rules/sotd/publish.js +++ b/lib/rules/sotd/publish.js @@ -50,7 +50,7 @@ export async function check(sr, done) { }, doAfter() { baseURL = - /^https:\/\/www.w3.org\/(2023\/Process-|policies\/process\/)20231103\//; + /^https:\/\/www.w3.org\/policies\/process\/202508XX\//; }, }); diff --git a/lib/rules/sotd/stability.js b/lib/rules/sotd/stability.js index 49d50f836..9c9037891 100644 --- a/lib/rules/sotd/stability.js +++ b/lib/rules/sotd/stability.js @@ -109,10 +109,8 @@ export async function check(sr, done) { ); if (!review) sr.error(self, 'no-cr-review'); else if ( - ![ - 'https://www.w3.org/2023/Process-20231103/#dfn-wide-review', - 'https://www.w3.org/policies/process/20231103/#dfn-wide-review', - ].includes(review.href) + review.href !== + 'https://www.w3.org/policies/process/202508XX/#dfn-wide-review' ) sr.error(self, 'wrong-cr-review-link'); } diff --git a/test/doc-views/TR/Recommendation/REC.js b/test/doc-views/TR/Recommendation/REC.js index 77c736263..7ab6fb215 100644 --- a/test/doc-views/TR/Recommendation/REC.js +++ b/test/doc-views/TR/Recommendation/REC.js @@ -140,7 +140,7 @@ export default { showProposedAdd: true, }, processHTML: - '03 November 2023 W3C Process Document', + 'XX August 2025 W3C Process Document', }, }, }, diff --git a/test/doc-views/TR/TRBase.js b/test/doc-views/TR/TRBase.js index a36968a96..3f274cc50 100644 --- a/test/doc-views/TR/TRBase.js +++ b/test/doc-views/TR/TRBase.js @@ -111,7 +111,7 @@ export function buildCommonViewData(base) { sotd: { ...base.sotd, processLink: - 'https://www.w3.org/wrong/link/2023/Process-20231103/', + 'https://www.w3.org/wrong/link/2023/Process-202508XX/', }, }, duplicatedProcess: { @@ -151,7 +151,7 @@ export function buildCommonViewData(base) { sotd: { ...base.sotd, trackLink: - 'https://www.w3.org/policies/process/20231103/#wrong-url', + 'https://www.w3.org/policies/process/202508XX/#wrong-url', }, }, noHomepageLink: { diff --git a/test/doc-views/layout/spec.handlebars b/test/doc-views/layout/spec.handlebars index 07c7b8ee4..9f486cf19 100644 --- a/test/doc-views/layout/spec.handlebars +++ b/test/doc-views/layout/spec.handlebars @@ -203,7 +203,7 @@

{{#if sotd.rec.showProposedAdd}}

- It includes proposed addition, introducing new features since the Previous Recommendation. + It includes proposed addition, introducing new features since the Previous Recommendation.

{{/if}} {{#if sotd.rec.showAddition}} @@ -243,11 +243,11 @@ {{> patent-policy}}

- This document {{sotd.processTextPrefix}}{{! is governed by the}} {{{sotd.processHTML}}}{{! 03 November 2023 W3C Process Document }}. + This document {{sotd.processTextPrefix}}{{! is governed by the}} {{{sotd.processHTML}}}{{! XX August 2025 W3C Process Document }}.

{{#if sotd.duplicateProcess}}

- This document {{sotd.processTextPrefix}}{{! is governed by the}} {{{sotd.processHTML}}}{{! 03 November 2023 W3C Process Document }}. + This document {{sotd.processTextPrefix}}{{! is governed by the}} {{{sotd.processHTML}}}{{! XX August 2025 W3C Process Document }}.

{{/if}} {{#if sotd.newFeatures.show}} diff --git a/test/doc-views/partials/stability.handlebars b/test/doc-views/partials/stability.handlebars index 21a3945d6..7e6646bf1 100644 --- a/test/doc-views/partials/stability.handlebars +++ b/test/doc-views/partials/stability.handlebars @@ -21,7 +21,7 @@ DISC: Publication as a Discontinued Draft implies that this document is no longer intended to advance or to be maintained. It is inappropriate to cite this document as other than abandoned work. - CR: Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received wide review, is intended to gather implementation experience, and has commitments from Working Group members to royalty-free licensing for implementations. + CR: Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received wide review, is intended to gather implementation experience, and has commitments from Working Group members to royalty-free licensing for implementations. CRD: Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Draft integrates changes from the previous Candidate Recommendation that the Working Group intends to include in a subsequent Candidate Recommendation Snapshot. + @@ -72,7 +72,7 @@ DRY: Publication as a Draft Registry does not imply endorsement by W3C and its Members. This is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to cite this document as other than a work in progress. - CRY: Publication as a Candidate Registry Snapshot does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received wide review. + CRY: Publication as a Candidate Registry Snapshot does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received wide review. CRYD: Publication as a Candidate Registry Draft does not imply endorsement by W3C and its Members. A Candidate Registry Draft integrates changes from the previous Candidate Registry that the Working Group intends to include in a subsequent Candidate Registry Snapshot. diff --git a/test/doc-views/specBase.js b/test/doc-views/specBase.js index f004b2537..da3025aea 100644 --- a/test/doc-views/specBase.js +++ b/test/doc-views/specBase.js @@ -139,7 +139,7 @@ export const data = { WGLink: 'https://www.w3.org/groups/wg/i18n-core/', trackLink: - 'https://www.w3.org/policies/process/20231103/#recs-and-notes', + 'https://www.w3.org/policies/process/202508XX/#recs-and-notes', extra1: '', noEndorsementHTML: 'does not imply endorsement by W3C and its Members', @@ -153,7 +153,7 @@ export const data = { discText: 'intended to advance or to be maintained', wideReviewText: 'wide review', wideReviewLink: - 'https://www.w3.org/policies/process/20231103/#dfn-wide-review', + 'https://www.w3.org/policies/process/202508XX/#dfn-wide-review', recConsensusText: 'after extensive consensus-building', licensingText: 'royalty-free licensing', @@ -187,9 +187,9 @@ export const data = { duplicateProcess: false, processTextPrefix: 'is governed by the', - processLink: 'https://www.w3.org/policies/process/20231103/', + processLink: 'https://www.w3.org/policies/process/202508XX/', processHTML: - '03 November 2023 W3C Process Document', + 'XX August 2025 W3C Process Document', newFeatures: { show: false, text: 'Future updates to this Recommendation may incorporate new features.', diff --git a/test/docs/2021-cr.html b/test/docs/2021-cr.html index d308aa1d6..222d3c576 100644 --- a/test/docs/2021-cr.html +++ b/test/docs/2021-cr.html @@ -84,7 +84,7 @@

Status of This Document

This document was published by the Web Performance Working Group as a Candidate Recommendation Snapshot using the Recommendation + href="https://www.w3.org/policies/process/202508XX/#recs-and-notes">Recommendation track.

@@ -92,7 +92,7 @@

Status of This Document

Publication as a Candidate Recommendation does not imply endorsement by W3C and its Members. A Candidate Recommendation Snapshot has received wide review, is intended to + href="https://www.w3.org/policies/process/202508XX/#dfn-wide-review">wide review, is intended to gather implementation experience, and has commitments from Working Group members to royalty-free licensing for implementations.

@@ -111,7 +111,7 @@

Status of This Document

Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent that the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.

- This document is governed by the 03 November 2023 W3C Process Document. + This document is governed by the XX August 2025 W3C Process Document.

diff --git a/test/docs/2021-crd.html b/test/docs/2021-crd.html index 418c2e45f..e94b37c9a 100644 --- a/test/docs/2021-crd.html +++ b/test/docs/2021-crd.html @@ -102,7 +102,7 @@

Status of This Document

This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C standards and drafts index.

-

This document was published by the Web Performance Working Group as a Candidate Recommendation Draft using the Recommendation track.

+

This document was published by the Web Performance Working Group as a Candidate Recommendation Draft using the Recommendation track.

Publication as a Candidate Recommendation does not imply endorsement by Status of This Document

- This document is governed by the 03 November 2023 W3C Process Document. + This document is governed by the XX August 2025 W3C Process Document.