Skip to content

Commit 932f429

Browse files
authored
[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.
1 parent be6e048 commit 932f429

File tree

1 file changed

+1
-18
lines changed

1 file changed

+1
-18
lines changed

documentreview/index.md

Lines changed: 1 addition & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -214,7 +214,7 @@ Is there such a thing as too many reviews?
214214
Is it possible to make too many requests for review?
215215
: 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.
216216

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 [<abbr title="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…
218218

219219
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.
220220

@@ -233,23 +233,6 @@ Is it possible to make too many requests for review?
233233

234234
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.
235235

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-
253236
## Enhancement Requests
254237

255238
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

Comments
 (0)