Skip to content

Commit b0ce9b1

Browse files
Move 'In-place modification of W3C Technical Reports' from https://www.w3.org/2003/01/republishing/ to /guide/standards-track/republishing
1 parent 9651bd8 commit b0ce9b1

File tree

6 files changed

+64
-5
lines changed

6 files changed

+64
-5
lines changed

index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ toc: true
7272
- Considerations for [joint deliverables](process/joint-deliverables.md)
7373
- [Transition requirements](transitions/) for all W3C maturity levels (First Public Draft, CR, PR, REC, etc.). Try also our [step finder](transitions/nextstep.html) and look at [milestones calculator](https://w3c.github.io/spec-releases/milestones/).
7474
- [Request Wide Review](documentreview/) at least *2-3 months before CR*, to allow time for discussion and rework. This includes requesting [horizontal reviews](documentreview/#how-to-get-horizontal-review).
75-
- [Pubrules](https://www.w3.org/pubrules/) ([publication requirements](https://www.w3.org/pubrules/doc)) and links to related policies (e.g., [namespaces](https://www.w3.org/2005/07/13-nsuri), [MIME type registration](https://www.w3.org/2020/01/registering-mediatypes), [version management](https://www.w3.org/2005/05/tr-versions), and [in-place modifications](https://www.w3.org/2003/01/republishing/))
75+
- [Pubrules](https://www.w3.org/pubrules/) ([publication requirements](https://www.w3.org/pubrules/doc)) and links to related policies (e.g., [namespaces](https://www.w3.org/2005/07/13-nsuri), [MIME type registration](https://www.w3.org/2020/01/registering-mediatypes), [version management](https://www.w3.org/2005/05/tr-versions), and [in-place modifications](standards-track/republishing.md))
7676
See also [Pubrules issue management](https://github.com/w3c/specberus/issues)
7777
- **March 2017**: [Obsoleting and Rescinding W3C Specifications](process/obsolete-rescinded-supserseded.md)
7878
- [Normative References](process/tilt/normative-references.md); considerations the Team takes into account when evaluating normative references

standards-track/republishing.md

+59
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: In-place modification of W3C Technical Reports
3+
toc: true
4+
---
5+
6+
_This is the W3C Communications Team's policy regarding the in-place modification of some W3C Technical reports. See also the [Persistence Policy for technical reports](https://www.w3.org/policies/uri-persistence/)._
7+
8+
## Classes of documents that may be modified {#classes}
9+
10+
1. Only "end state" documents may be modified in place at any time: Recommendations and Working Group Notes. See [permitted classes of modifications for "end state" documents](#endstate-modification)
11+
2. Revised Working Drafts (not First Public Working Drafts) may be modified in place *on the day of publication*. See [Modifications for ordinary Working Drafts](#ordinary-wds)
12+
3. Other classes of documents are corrected through republication.
13+
4. If a document has been superseded, it should not be modified in place.
14+
15+
## Permitted classes of modifications for "end state" documents {#endstate-modification}
16+
17+
The only modifications allowed in place are:
18+
19+
1. Fixes to broken markup (e.g., invalid markup)
20+
1. Fixed to broken links (i.e., URIs)
21+
1. Fixes to broken style sheets
22+
1. Some visible status updates, such as indicating newer versions
23+
1. [An individual's name upon request to a W3C Ombudsperson](https://www.w3.org/2016/02/trans-rec-edit.html)
24+
25+
Except for those changes required by this policy in section four, no in-place changes to the text of a document, besides some visible status updates, are permitted, however minor.
26+
27+
## Availability of the original version for "end state" documents {#availability}
28+
29+
The Webmaster must ensure that the original version of the document (i.e., before the in-place modification) is available in CVS.
30+
31+
**Note:** The public should have access to the original version through a public read-only CVS server. One approach is to rename the original files and link to them from the status section of the new doc. The old docs should have updated status to indicate that they have been superseded and why.
32+
33+
## Indication of changes in the document for "end state" documents {#indication}
34+
35+
1. The title page publication date must not be changed
36+
1. There must be a "reprinting" date in addition to the title page publication date. Example:
37+
38+
*W3C Recommendation 15 March 2003 (Format and link errors corrected 1 Jan 2004)*
39+
1. The status section should provide further information about the nature of the changes.
40+
1. The status section should explain that the Team has kept a copy of the original draft.
41+
42+
Examples:
43+
44+
- [https://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113/](https://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113/)
45+
- [https://www.w3.org/TR/2003/REC-xptr-framework-20030325/](https://www.w3.org/TR/2003/REC-xptr-framework-20030325/)
46+
- [https://www.w3.org/TR/2016/NOTE-url-1-20161206/](https://www.w3.org/TR/2016/NOTE-url-1-20161206/)
47+
48+
## Requesting an in-place modification for "end state" documents {#requesting}
49+
50+
Editors (or others) send a request to the Webmaster, cc'ing the project management lead, webreq, and w3t-comm. The request must include:
51+
52+
1. A detailed list of changes
53+
1. Revised document(s) (including revised status section)
54+
55+
If these conditions are met, the Webmaster will replace the published documents with the modified ones.
56+
57+
## Modifications for ordinary Working Drafts {#ordinary-wds}
58+
59+
A revised Working Draft may be modified in-place only if the modifications are done on the *same day* of the original publication (Boston time). There are no restrictions on the set of permitted modifications and there is no need to indicate the changes in the document. Republication is achieved using the [W3C automatic publishing system](https://github.com/w3c/echidna/wiki).

transitions/details.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This document does not address:
1010
- Requirements for documents themselves; see [Technical Report Publication Policy](https://www.w3.org/pubrules/doc) ("pubrules") for this information.
1111
- What required information must be public; this is covered in [section 7.2](https://www.w3.org/policies/process/#requirements-and-definitions) of the Process Document and in the governing patent policy.
1212
- Possible next steps after each transition; see the description of the [Recommendation Track Process](https://www.w3.org/policies/process/#Reports).
13-
- The Comm Team's policy regarding [in-place modification of W3C Technical Reports](https://www.w3.org/2003/01/republishing/).
13+
- The Comm Team's policy regarding [in-place modification of W3C Technical Reports](../standards-track/republishing.md).
1414

1515
Exceptions to these processes MAY be authorized by [@w3c/transitions](https://github.com/orgs/w3c/teams/transitions).
1616

transitions/index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@
122122

123123
<p>You <em class="rfc2119">may</em> also follow <a href="?profile=CR&amp;cr=rec-update">Candidate Recommendation</a> for substantive corrections</p>
124124

125-
<p>We allow some <strong>in place modifications</strong> of Recommendations, including markup changes. See <a href="https://www.w3.org/2003/01/republishing/">In-place modification of W3C Technical Reports</a>.</p>
125+
<p>We allow some <strong>in place modifications</strong> of Recommendations, including markup changes. See <a href="https://www.w3.org/guide/standards-track/republishing">In-place modification of W3C Technical Reports</a>.</p>
126126
</div>
127127

128128
<div class="field">

transitions/nextstep.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ <h2 id='resources'>Other resources</h2>
135135
}
136136

137137
let BASE = "https://www.w3.org/guide/transitions/";
138-
let INPLACE = "<li><a href='https://www.w3.org/2003/01/republishing/'>In-place modification of W3C Technical Reports</a></li>";
138+
let INPLACE = "<li><a href='https://www.w3.org/guide/standards-track/republishing/'>In-place modification of W3C Technical Reports</a></li>";
139139
function listItem(text, query) {
140140
return "<li><a href='" + BASE + '?' + query + "'>" + text + "</a></li>";
141141
}

transitions/wide-review-request.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ <h2 id="resources">Other resources</h2>
177177
}
178178

179179
let BASE = "https://www.w3.org/guide/transitions?";
180-
let INPLACE = "<li><a href='https://www.w3.org/2003/01/republishing/'>In-place modification of W3C Technical Reports</a></li>";
180+
let INPLACE = "<li><a href='https://www.w3.org/guide/standards-track/republishing/'>In-place modification of W3C Technical Reports</a></li>";
181181
function listItem(text, query) {
182182
let id = "option" + Math.round(Math.random() * 10000);
183183
return `<li>`

0 commit comments

Comments
 (0)