You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[documentreview] Drop terminology and abbreviations section (#372)
Via #273.
The terms and abbreviations listed in that section were not used
anywhere in the guidebook, except "TR", used in this page. I turned the
first occurrence into an abbreviation with a link to
`https://www.w3.org/TR/` to clarify its meaning.
Copy file name to clipboardExpand all lines: documentreview/index.md
+1-18Lines changed: 1 addition & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -214,7 +214,7 @@ Is there such a thing as too many reviews?
214
214
Is it possible to make too many requests for review?
215
215
: Yes. To help the review groups, only request updated reviews when substantive changes have been made, and clearly identify the changes since the last review.
216
216
217
-
This is also the reason that the Process clearly suggests there should be (TR) Working Drafts published when there are "significant changes that would benefit from review beyond the Working Group", rather than every day or only twice in the life of a spec…
217
+
This is also the reason that the Process clearly suggests there should be [<abbrtitle="Technical report">TR</abbr>](https://www.w3.org/TR/) Working Drafts published when there are "significant changes that would benefit from review beyond the Working Group", rather than every day or only twice in the life of a spec…
218
218
219
219
TR Working Drafts are also useful for reviews since they provide a dated snapshot which can be recovered when the review comments are being discussed. Trying to discuss review comments against a document which has changed out of all recognition can be a frustrating and inefficient experience.
220
220
@@ -233,23 +233,6 @@ Is it possible to make too many requests for review?
233
233
234
234
They may not even be able to find someone with availability to do the review in that time, and then they need a week or two to discuss their response after the review, and then they'll send you comments that may require you to make substantive changes.
235
235
236
-
## Terminology and abbreviations
237
-
238
-
pre-CR
239
-
: This is a version of a Working Draft that is created to get wide review.
240
-
241
-
> Note that this is a bad way to get review. In general, features should be reviewed as they are developed. Waiting for a "Last Call" for most review means that when reviews suggest changes it is far harder to make them, due to a commonly observed and logical reluctance to break deployed systems or content. -- [Charles McCathie Nevile](https://www.w3.org/wiki/User:Charles) 11:18, 13 October 2014 (UTC)
242
-
243
-
requesting group
244
-
: a group that is requesting a review
245
-
246
-
**Abbreviations:**
247
-
* BP = Best Practices
248
-
* CR = Candidate Recommendation
249
-
* RfC = Request for Comments (aka Review Request)
250
-
*[TR](https://www.w3.org/TR/) = Technical Report, i.e. a formal W3C publication.
251
-
* WD = Working Draft
252
-
253
236
## Enhancement Requests
254
237
255
238
See the [Document Review Dashboard](https://www.w3.org/wiki/Dashboard#Document_Review_Dashboard) document for information about creating a dashboard type service to facilitate document reviews.
0 commit comments