Skip to content

Commit fe35b50

Browse files
committed
Update wording to reflect Steve Zilles' proposal <http://lists.w3.org/Archives/Public/www-style/2011Apr/0760.html>
1 parent 99fe531 commit fe35b50

File tree

2 files changed

+66
-44
lines changed

2 files changed

+66
-44
lines changed

css-2010/Overview.html

+37-25
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@
1515

1616
<h1>Cascading Style Sheets (CSS) Snapshot 2010</h1>
1717

18-
<h2 class="no-num no-toc" id=w3c-note-date>W3C Note 26 April 2011</h2>
18+
<h2 class="no-num no-toc" id=w3c-note-date>W3C Note 2 May 2011</h2>
1919

2020
<dl>
2121
<dt>This version:</dt>
22-
<!-- <dd><a href="http://www.w3.org/TR/2011/WD-css-2010-20110426">http://www.w3.org/TR/2011/ED-css-2010-20110426</a></dd> -->
22+
<!-- <dd><a href="http://www.w3.org/TR/2011/WD-css-2010-20110502">http://www.w3.org/TR/2011/ED-css-2010-20110502</a></dd> -->
2323

2424
<dd><a
2525
href="http://dev.w3.org/csswg/css-2010/">http://dev.w3.org/csswg/css-2010/</a>
@@ -142,11 +142,16 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
142142
Implementations</a>
143143
</ul>
144144

145-
<li><a href="#properties"><span class=secno>4. </span>Property Index</a>
145+
<li><a href="#indices"><span class=secno>4. </span>Indices</a>
146+
<ul class=toc>
147+
<li><a href="#properties"><span class=secno>4.1. </span>Property
148+
Index</a>
146149

147-
<li><a href="#selectors"><span class=secno>5. </span>Selector Index</a>
150+
<li><a href="#selectors"><span class=secno>4.2. </span>Selector
151+
Index</a>
148152

149-
<li><a href="#at-rules"><span class=secno>6. </span>At-Rule Index</a>
153+
<li><a href="#at-rules"><span class=secno>4.3. </span>At-Rule Index</a>
154+
</ul>
150155
</ul>
151156
<!--end-toc-->
152157

@@ -360,33 +365,44 @@ <h3 id=experimental><span class=secno>3.3. </span>Experimental
360365
<p>To avoid clashes with future CSS features, the CSS2.1 specification
361366
reserves a <a
362367
href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
363-
syntax</a> for proprietary property and value extensions to CSS. The CSS
364-
Working Group recommends that experimental implementations of features in
365-
CSS Working Drafts also use vendor-prefixed property or value names. This
366-
avoids any incompatibilities with future changes in the draft. Once a
367-
specification reaches the Candidate Recommendation stage, implementors
368-
should implement the non-prefixed syntax for any feature they consider to
369-
be correctly implemented according to spec.
368+
syntax</a> for proprietary and experimental extensions to CSS. Prior to a
369+
specification reaching the Candidate Recommendation stage in the W3C
370+
process, all implementations of a CSS feature are considered experimental.
371+
The CSS Working Group recommends that implementations use the
372+
vendor-prefixed syntax for such features, including those in W3C Working
373+
Drafts. This avoids incompatibilities with future changes in the draft.
370374

371375
<h3 id=testing><span class=secno>3.4. </span>Non-Experimental
372376
Implementations</h3>
373377

378+
<p>Once a specification reaches the Candidate Recommendation stage,
379+
non-experimental implementations are possible, and implementors should
380+
release an unprefixed implementation of any CR-level feature they can
381+
demonstrate to be correctly implemented according to spec.
382+
374383
<p>To establish and maintain the interoperability of CSS across
375384
implementations, the CSS Working Group requests that non-experimental CSS
376385
renderers submit an implementation report (and, if necessary, the
377386
testcases used for that implementation report) to the W3C before releasing
378-
an unprefixed implementation of any CSS features. CSS2.1 implementations
379-
are encouraged, but not required, to submit such a report.
387+
an unprefixed implementation of any CSS features. Testcases submitted to
388+
W3C are subject to review and correction by the CSS Working Group.
380389

381390
<p>Further information on submitting testcases and implementation reports
382391
can be found from on the CSS Working Group's website at <a
383392
href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
384-
393+
Questions should be directed to the <a
394+
href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
395+
mailing list.
385396

386-
<h2 id=properties><span class=secno>4. </span>Property Index</h2>
397+
<p>CSS2.1 implementations are encouraged, but not required, to submit an
398+
implementation report.
399+
400+
<h2 id=indices><span class=secno>4. </span>Indices</h2>
387401

388402
<p><em>This section is non-normative.</em>
389403

404+
<h3 id=properties><span class=secno>4.1. </span>Property Index</h3>
405+
390406
<table class=proptable>
391407
<thead>
392408
<tr>
@@ -2350,9 +2366,7 @@ <h2 id=properties><span class=secno>4. </span>Property Index</h2>
23502366
<td><a href="media.html#visual-media-group">visual</a>
23512367
</table>
23522368

2353-
<h2 id=selectors><span class=secno>5. </span>Selector Index</h2>
2354-
2355-
<p><em>This section is non-normative.</em>
2369+
<h3 id=selectors><span class=secno>4.2. </span>Selector Index</h3>
23562370

23572371
<table class=data>
23582372
<thead>
@@ -2788,21 +2802,19 @@ <h2 id=selectors><span class=secno>5. </span>Selector Index</h2>
27882802
<td>3
27892803
</table>
27902804

2791-
<h2 id=at-rules><span class=secno>6. </span>At-Rule Index</h2>
2792-
2793-
<p><em>This section is non-normative.</em>
2805+
<h3 id=at-rules><span class=secno>4.3. </span>At-Rule Index</h3>
27942806

27952807
<ul>
27962808
<li><a href="http://www.w3.org/TR/CSS21/syndata.html#charset">@charset</a>
27972809

27982810

27992811
<li><a
2800-
href="http://www.w3.org/TR/CSS21/cascade.html#at-import">@import</a> with
2801-
the media list replaced by a <a
2812+
href="http://www.w3.org/TR/CSS21/cascade.html#at-import">@import</a>,
2813+
with the media list replaced by a <a
28022814
href="http://www.w3.org/TR/css3-mediaqueries/">media query list</a>
28032815

28042816
<li><a
2805-
href="http://www.w3.org/TR/CSS21/media.html#at-media-rule">@media</a>
2817+
href="http://www.w3.org/TR/CSS21/media.html#at-media-rule">@media</a>,
28062818
with the media list replaced by a <a
28072819
href="http://www.w3.org/TR/css3-mediaqueries/">media query list</a>
28082820

css-2010/Overview.src.html

+29-19
Original file line numberDiff line numberDiff line change
@@ -240,32 +240,46 @@ <h3 id="experimental">Experimental Implementations</h3>
240240

241241
<p>To avoid clashes with future CSS features, the CSS2.1 specification
242242
reserves a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
243-
syntax</a> for proprietary property and value extensions to CSS. The CSS
244-
Working Group recommends that experimental implementations of features in
245-
CSS Working Drafts also use vendor-prefixed property or value names. This
246-
avoids any incompatibilities with future changes in the draft. Once a
247-
specification reaches the Candidate Recommendation stage, implementors
248-
should implement the non-prefixed syntax for any feature they consider to
249-
be correctly implemented according to spec.</p>
243+
syntax</a> for proprietary and experimental extensions to CSS. Prior
244+
to a specification reaching the Candidate Recommendation stage in the
245+
W3C process, all implementations of a CSS feature are considered
246+
experimental. The CSS Working Group recommends that implementations
247+
use the vendor-prefixed syntax for such features, including those in
248+
W3C Working Drafts. This avoids incompatibilities with future changes
249+
in the draft.
250+
</p>
250251

251252
<h3 id="testing">Non-Experimental Implementations</h3>
252253

254+
<p>Once a specification reaches the Candidate Recommendation stage,
255+
non-experimental implementations are possible, and implementors should
256+
release an unprefixed implementation of any CR-level feature they
257+
can demonstrate to be correctly implemented according to spec.
258+
253259
<p>To establish and maintain the interoperability of CSS across
254260
implementations, the CSS Working Group requests that non-experimental
255261
CSS renderers submit an implementation report (and, if necessary, the
256262
testcases used for that implementation report) to the W3C before
257-
releasing an unprefixed implementation of any CSS features. CSS2.1
258-
implementations are encouraged, but not required, to submit such a
259-
report.
263+
releasing an unprefixed implementation of any CSS features. Testcases
264+
submitted to W3C are subject to review and correction by the CSS
265+
Working Group.
260266

261267
<p>Further information on submitting testcases and implementation reports
262268
can be found from on the CSS Working Group's website at
263269
<a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
270+
Questions should be directed to the
271+
<a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
272+
mailing list.
273+
274+
<p>CSS2.1 implementations are encouraged, but not required, to submit
275+
an implementation report.
264276

265-
<h2 id="properties">Property Index</h2>
277+
<h2 id="indices">Indices</h2>
266278

267279
<p><em>This section is non-normative.</em></p>
268280

281+
<h3 id="properties">Property Index</h3>
282+
269283
<table class="proptable">
270284
<thead><tr><th>Name<th>Values<th>Initial value<th>Applies to<th>Inherited?<th>Percentages<th>Media</thead>
271285

@@ -1279,9 +1293,7 @@ <h2 id="properties">Property Index</h2>
12791293
</tbody>
12801294
</table>
12811295

1282-
<h2 id="selectors">Selector Index</h2>
1283-
1284-
<p><em>This section is non-normative.</em></p>
1296+
<h3 id="selectors">Selector Index</h3>
12851297

12861298
<table class=data>
12871299
<thead>
@@ -1570,13 +1582,11 @@ <h2 id="selectors">Selector Index</h2>
15701582
<td>3
15711583
</table>
15721584

1573-
<h2 id="at-rules">At-Rule Index</h2>
1574-
1575-
<p><em>This section is non-normative.</em></p>
1585+
<h3 id="at-rules">At-Rule Index</h3>
15761586

15771587
<ul>
15781588
<li><a href="http://www.w3.org/TR/CSS21/syndata.html#charset">@charset</a>
1579-
<li><a href="http://www.w3.org/TR/CSS21/cascade.html#at-import">@import</a> with the media list replaced by a <a href="http://www.w3.org/TR/css3-mediaqueries/">media query list</a>
1580-
<li><a href="http://www.w3.org/TR/CSS21/media.html#at-media-rule">@media</a> with the media list replaced by a <a href="http://www.w3.org/TR/css3-mediaqueries/">media query list</a>
1589+
<li><a href="http://www.w3.org/TR/CSS21/cascade.html#at-import">@import</a>, with the media list replaced by a <a href="http://www.w3.org/TR/css3-mediaqueries/">media query list</a>
1590+
<li><a href="http://www.w3.org/TR/CSS21/media.html#at-media-rule">@media</a>, with the media list replaced by a <a href="http://www.w3.org/TR/css3-mediaqueries/">media query list</a>
15811591
<li><a href="http://www.w3.org/TR/CSS21/page.html#page-box">@page</a>
15821592
</ul>

0 commit comments

Comments
 (0)