diff --git a/lib/rules.json b/lib/rules.json index 1950fe31f..aa2f30e8e 100644 --- a/lib/rules.json +++ b/lib/rules.json @@ -174,7 +174,7 @@ "customParagraph": true, "stability": "It must set expectations about the (in)stability of the document. The recommended text is:
", "draftStability": true, - "patentPolicy2017": true, + "patPolReq": true, "knownDisclosureNumber": true, "whichProcess": true } @@ -276,8 +276,8 @@ "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
Publication as a Draft Registry does not imply endorsement by W3C and its Members. A Candidate Registry Snapshot has received wide review.
<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/2021/Process-20211102/#dfn-wide-review\">wide review</a>.</p>
", "draftStability": "The document must include one of the following two paragraphs in the \"Status Of This Document\":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.
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 work in progress.
This document is maintained and updated at any time. Some parts of this document are work in progress.", - "patentPolicy2017": true, "knownDisclosureNumber": true, + "patPolReq": true, "whichProcess": true } }, @@ -480,8 +480,8 @@ "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.", "stability": "It must set expectations about the (in)stability of the document. The recommended text is:
A W3C Registry is a specification that, after extensive consensus-building, is endorsed by W3C and its Members.
", - "patentPolicy2017": true, "knownDisclosureNumber": true, + "patPolReq": true, "whichProcess": true } }, @@ -579,7 +579,6 @@ "rules": { "sotd": true, "boilerplateTRDoc": "It must begin with the following boilerplate text:This section describes the status of this document at the time of its publication. A list of current W3C publications can be found in the W3C technical reports index at https://www.w3.org/TR/.
Include this source code:", - "boilerplateSUBM": "It must include this boilerplate text (with links to the published Submission and Team Comment):<p><em>This section describes the status of this document at the time of its publication. A list of current W3C publications can be found in the <a href=\"https://www.w3.org/TR/\">W3C technical reports index</a> at https://www.w3.org/TR/.</em></p>
By publishing this document, W3C acknowledges that the Submitting Members have made a formal Submission request to W3C for discussion. Publication of this document by W3C indicates no endorsement of its content by W3C, nor that W3C has, is, or will be allocating any resources to the issues addressed by it. This document is not the product of a chartered W3C group, but is published as potential input to the W3C Process. A W3C Team Comment has been published in conjunction with this Member Submission. Publication of acknowledged Member Submissions at the W3C site is one of the benefits of W3C and its Members. Please consult the requirements associated with Member Submissions of section 3.3 of the W3C Patent Policy. Please consult the complete list of acknowledged W3C Member Submissions.Include this source code:", "publish": [ "Group Draft Note", "Note track", @@ -589,6 +588,7 @@ "stability": "It must set expectations about the (in)stability of the document. The recommended text is:<p>By publishing this document, W3C acknowledges that the <a href=\"https://www.w3.org/Submission/@@@submissiondoc@@@\">Submitting Members</a> have made a formal Submission request to W3C for discussion. Publication of this document by W3C indicates no endorsement of its content by W3C, nor that W3C has, is, or will be allocating any resources to the issues addressed by it. This document is not the product of a chartered W3C group, but is published as potential input to the <a href=\"https://www.w3.org/Consortium/Process\">W3C Process</a>. A <a href=\"https://www.w3.org/Submission/@@@teamcomment@@@\">W3C Team Comment</a> has been published in conjunction with this Member Submission. Publication of acknowledged Member Submissions at the W3C site is one of the benefits of <a href=\"https://www.w3.org/Consortium/Prospectus/Joining\">W3C Membership</a>. Please consult the requirements associated with Member Submissions of <a href=\"https://www.w3.org/Consortium/Patent-Policy/#sec-submissions\">section 3.3 of the W3C Patent Policy</a>. Please consult the complete <a href=\"https://www.w3.org/Submission\">list of acknowledged W3C Member Submissions</a>.</p>
", "draftStability": true, "knownDisclosureNumber": true, + "patPolReq": true, "whichProcess": true } }, @@ -690,6 +690,7 @@ "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.
", "draftStability": true, "knownDisclosureNumber": true, + "patPolReq": true, "whichProcess": true } }, @@ -789,8 +790,8 @@ ], "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.
A W3C Statement is a specification that, after extensive consensus-building, is endorsed by W3C and its Members.
Include this source code:", - "patentPolicy2017": true, "knownDisclosureNumber": true, + "patPolReq": true, "whichProcess": true } }, @@ -1437,7 +1438,7 @@ "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:<p>A W3C Statement is a specification that, after extensive consensus-building, is endorsed by W3C and its Members.</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.", + "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", @@ -1821,8 +1822,7 @@ "deployment": "It must include the expections in terms of deployment. The recommended text is:
- Recommendation without modifications:
This document was published by the @@ Working Group as a Recommendation.Include this source code:<p>This document was published by the @@ Working Group as a Recommendation.</p>
- Recommendation with candidate corrections:
This document was published by the @@ Working Group as a Recommendation. It includes candidate corrections.Include this source code:<p>This document was published by the @@ Working Group as a Recommendation. This document was published by the @@ Working Group as a Recommendation. It includes <a href=\"https://www.w3.org/2021/Process-20211102/#candidate-correction\">candidate corrections.</a>.</p>
- Recommendation with candidate additions:
This document was published by the @@ Working Group as a Recommendation. 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. This document was published by the @@ Working Group as a Recommendation. It includes <a href=\"https://www.w3.org/2021/Process-20211102/#candidate-addition\">candidate additions</a>, introducing new features since the Previous Recommendation.</p>
- Recommendation with candidate amendments:
This document was published by the @@ Working Group as a Recommendation. 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. This document was published by the @@ Working Group as a Recommendation. It includes <a href=\"https://www.w3.org/2021/Process-20211102/#candidate-amendments\">candidate amendments</a>, introducing substantive changes and new features since the Previous Recommendation.</p>
- Recommendation with proposed corrections:
This document was published by the @@ Working Group as a Recommendation. It includes proposed corrections.Include this source code:<p>This document was published by the @@ Working Group as a Recommendation. This document was published by the @@ Working Group as a Recommendation. It includes <a href=\"https://www.w3.org/2021/Process-20211102/#proposed-corrections\">proposed corrections.</a>.</p>
- Recommendation with proposed additions:
This document was published by the @@ Working Group as a Recommendation. 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. This document was published by the @@ Working Group as a Recommendation. It includes <a href=\"https://www.w3.org/2021/Process-20211102/#proposed-addition\">proposed additions</a>, introducing new features since the Previous Recommendation.</p>
- Recommendation with proposed amendments:
This document was published by the @@ Working Group as a Recommendation. 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. This document was published by the @@ Working Group as a Recommendation. It includes <a href=\"https://www.w3.org/2021/Process-20211102/#proposed-amendments\">proposed amendments</a>, introducing substantive changes and new features since the Previous Recommendation.</p>
W3C recommends the wide deployment of this specification as a standard for the Web.", "stability": "It must set expectations about the (in)stability of the document. The recommended text @{param2} is:Publication as @{param1} does not imply endorsement by W3C and its Members.
Include this source code:", "draftStability": "It must include the following sentences in the \"Status Of This Document\":<p>Publication as @{param1} does not imply endorsement by W3C and its Members.</p>
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 work in progress.", - "patentPolicy2017": "It must set the licensing requirements related to the Patent Policy 2017. The recommended text is:The 1 August 2017 W3C Patent Policy does not carry any licensing requirements or commitments on this document.
Include this source code:", - "patPolReq": "It must include this text related to patent policy* requirements (with suitable links inserted; see guidelines for linking to disclosure pages):<p>The <a href=\"https://www.w3.org/Consortium/Patent-Policy-20170801/\">1 August 2017 W3C Patent Policy</a> does not carry any licensing requirements or commitments on this document.</p>
*If the Working Group is operating under the Patent Policy 2017, the link to the Patent Policy should be https://www.w3.org/Consortium/Patent-Policy-20170801/.This document was produced by a group operating under the W3C 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 which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
Include this source code:<p> This document was produced by a group operating under the <a href=\"https://www.w3.org/Consortium/Patent-Policy/\">W3C Patent Policy</a>. W3C maintains a <a rel=\"disclosure\" href=\"@@URI to IPP status or other page@@\">public list of any patent disclosures</a> 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 which the individual believes contains <a href=\"https://www.w3.org/Consortium/Patent-Policy/#def-essential\">Essential Claim(s)</a> must disclose the information in accordance with <a href=\"https://www.w3.org/Consortium/Patent-Policy/#sec-Disclosure\">section 6 of the W3C Patent Policy</a>. </p>
Note: Contact the Communications Team for suitable adaptations in the case where a document has been published jointly by more than one group. In the adaptation, be sure that the text for informative-only specs or specs not going to Rec is the same as the standard text.
", + "patPolReq": "It must include a text related to the patent policy:
- if the Working Group is operating under the Patent Policy 2020, the text is:
This document was produced by a group operating under the W3C 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 which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
Include this source code:<p>This document was produced by a group operating under the <a href=\"https://www.w3.org/Consortium/Patent-Policy/\">W3C Patent Policy</a>. W3C maintains a <a rel=\"disclosure\" href=\"@@URI to IPP status or other page@@\">public list of any patent disclosures</a> 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 which the individual believes contains <a href=\"https://www.w3.org/Consortium/Patent-Policy/#def-essential\">Essential Claim(s)</a> must disclose the information in accordance with <a href=\"https://www.w3.org/Consortium/Patent-Policy/#sec-Disclosure\">section 6 of the W3C Patent Policy</a>.</p>
- if the Working Group is operating under the Patent Policy 2017, the text is:
This document was produced by a group operating under the 1 August 2017 W3C 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 which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
Include this source code:<p>This document was produced by a group operating under the <a href=\"https://www.w3.org/Consortium/Patent-Policy-20170801/\">1 August 2017 W3C Patent Policy</a>. W3C maintains a <a rel=\"disclosure\" href=\"@@URI to IPP status or other page@@\">public list of any patent disclosures</a> 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 which the individual believes contains <a href=\"https://www.w3.org/Consortium/Patent-Policy-20170801/#def-essential\">Essential Claim(s)</a> must disclose the information in accordance with <a href=\"https://www.w3.org/Consortium/Patent-Policy-20170801/#sec-Disclosure\">section 6 of the W3C Patent Policy</a>.</p>
- if the document is under Note track or Registry track, it must set the licensing requirements related to the Patent Policy. The text is:
The W3C Patent Policy does not carry any licensing requirements or commitments on this document.
Include this source code:<p>The <a href=\"https://www.w3.org/Consortium/Patent-Policy/\">W3C Patent Policy</a> does not carry any licensing requirements or commitments on this document.</p>
- if the Note track or Registry track document is published by a Working Group operating under the 2017 W3C Patent Policy, the text is:
", "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:The 1 August 2017 W3C Patent Policy does not carry any licensing requirements or commitments on this document.
Include this source code:<p>The <a href=\"https://www.w3.org/Consortium/Patent-Policy-20170801/\">1 August 2017 W3C Patent Policy</a> does not carry any licensing requirements or commitments on this document.</p>
Note: Contact the Communications Team for suitable adaptations in the case where a document has been published jointly by more than one group. In the adaptation, be sure that the text for informative-only specs or specs not going to Rec is the same as the standard text.
This document is governed by the 2 November 2021 W3C Process Document.
Include this source code:", "discontinue": "If the document was published due to a W3C decision to stop work on this material, the status section should include that rationale.", diff --git a/lib/rules/sotd/pp.js b/lib/rules/sotd/pp.js index 12b78963f..c971b29ba 100644 --- a/lib/rules/sotd/pp.js +++ b/lib/rules/sotd/pp.js @@ -2,6 +2,8 @@ const util = require('../../util'); const self = { name: 'sotd.pp', + section: 'document-status', + rule: 'patPolReq', }; const ppLink = 'https://www.w3.org/Consortium/Patent-Policy/'; @@ -87,12 +89,6 @@ function findPP(candidates, sr, isIGDeliverable) { exports.name = self.name; -const selfDisclosures = { - name: 'sotd.pp', - section: 'document-status', - rule: 'patPolReq', -}; - exports.check = async function (sr, done) { const groups = await sr.getDelivererGroups(); // Check if the document is published by WGs only. If IG/AB/TAG(s) are involved, the document cannot be on REC-track and should have a sentence meaning 'pp does not apply'. @@ -221,8 +217,7 @@ exports.check = async function (sr, done) { else if (patent === pp2020 && !found2020) sr.error(self, 'no-pp2020'); else if (!found2017 && !found2020) sr.error(self, 'no-pp-link', { expected }); - if (!foundPublicList && isRecTrack) - sr.error(selfDisclosures, 'no-disclosures'); + if (!foundPublicList && isRecTrack) sr.error(self, 'no-disclosures'); if ( (sr.config.track === 'Recommendation' || sr.config.track === 'Note') &&<p>This document is governed by the <a id=\"w3c_process_revision\" href=\"https://www.w3.org/2021/Process-20211102/\">2 November 2021 W3C Process Document</a>. </p>