Skip to content

Commit 7dcacbf

Browse files
committed
Update module template text to snapshot
1 parent e7aae8f commit 7dcacbf

File tree

2 files changed

+109
-61
lines changed

2 files changed

+109
-61
lines changed

css-module/Overview.html

+63-43
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,13 @@
1818
<h1>CSS <var class=issue>TEMPLATE</var> Module Level <var
1919
class=issue>N</var></h1>
2020

21-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 29 May 2011</h2>
21+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 20 June 2011</h2>
2222

2323
<dl>
2424
<dt>This version:
2525

26-
<dd><a href="http://www.w3.org/TR/2011/ED-css3-TEMPLATE-20110529/">
27-
http://www.w3.org/TR/2011/ED-css3-TEMPLATE-20110529</a>
26+
<dd><a href="http://www.w3.org/TR/2011/ED-css3-TEMPLATE-20110620/">
27+
http://www.w3.org/TR/2011/ED-css3-TEMPLATE-20110620</a>
2828

2929
<dt>Latest version:
3030

@@ -121,23 +121,21 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
121121
<!--begin-toc-->
122122

123123
<ul class=toc>
124-
<li><a href="#introduction"><span class=secno>1. </span>Introduction</a>
124+
<li><a href="#intro"><span class=secno>1. </span> Introduction</a>
125125
<ul class=toc>
126-
<li><a href="#context"><span class=secno>1.1. </span>Background</a>
127-
128-
<li><a href="#placement"><span class=secno>1.2. </span>Module
126+
<li><a href="#placement"><span class=secno>1.1. </span> Module
129127
Interactions</a>
130128

131-
<li><a href="#conventions"><span class=secno>1.3. </span>Document
129+
<li><a href="#conventions"><span class=secno>1.2. </span> Document
132130
Conventions</a>
133131

134-
<li><a href="#values"><span class=secno>1.4. </span>Values</a>
132+
<li><a href="#values"><span class=secno>1.3. </span> Values</a>
135133
</ul>
136134

137-
<li><a href="#sample-section"><span class=secno>2. </span>Sample
135+
<li><a href="#sample-topic"><span class=secno>2. </span> Sample
138136
section</a>
139137
<ul class=toc>
140-
<li><a href="#the-display-model"><span class=secno>2.1. </span>Inner
138+
<li><a href="#the-display-model"><span class=secno>2.1. </span> Inner
141139
Display Model: the &lsquo;<code
142140
class=property>display-model</code>&rsquo; property</a>
143141
</ul>
@@ -153,7 +151,10 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
153151
<li><a href="#experimental"><span class=secno>3.3. </span> Experimental
154152
Implementations</a>
155153

156-
<li><a href="#cr-exit-criteria"><span class=secno>3.4. </span> CR Exit
154+
<li><a href="#testing"><span class=secno>3.4. </span>Non-Experimental
155+
Implementations</a>
156+
157+
<li><a href="#cr-exit-criteria"><span class=secno>3.5. </span> CR Exit
157158
Criteria</a>
158159
</ul>
159160

@@ -173,15 +174,13 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
173174
</ul>
174175
<!--end-toc-->
175176

176-
<h2 id=introduction><span class=secno>1. </span>Introduction</h2>
177-
178-
<h3 id=context><span class=secno>1.1. </span>Background</h3>
177+
<h2 id=intro><span class=secno>1. </span> Introduction</h2>
179178

180179
<p><em>This section is not normative.</em>
181180

182181
<p><var class=issue>Provide background, motivation, etc.</var>
183182

184-
<h3 id=placement><span class=secno>1.2. </span>Module Interactions</h3>
183+
<h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
185184

186185
<p class=issue>Explain, normatively, how this module affects the definition
187186
of CSS.
@@ -191,7 +190,7 @@ <h3 id=placement><span class=secno>1.2. </span>Module Interactions</h3>
191190
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var class=issue>W.X
192191
and Y.Z</var>.
193192

194-
<h3 id=conventions><span class=secno>1.3. </span>Document Conventions</h3>
193+
<h3 id=conventions><span class=secno>1.2. </span> Document Conventions</h3>
195194

196195
<p>Conformance requirements are expressed with a combination of descriptive
197196
assertions and RFC 2119 terminology. The key words “MUST”, “MUST
@@ -218,7 +217,7 @@ <h3 id=conventions><span class=secno>1.3. </span>Document Conventions</h3>
218217

219218
<p class=note>Note, this is an informative note.
220219

221-
<h3 id=values><span class=secno>1.4. </span>Values</h3>
220+
<h3 id=values><span class=secno>1.3. </span> Values</h3>
222221

223222
<p>This specification follows the <a
224223
href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property
@@ -237,7 +236,7 @@ <h3 id=values><span class=secno>1.4. </span>Values</h3>
237236
keyword as their property value. For readability it has not been repeated
238237
explicitly.
239238

240-
<h2 id=sample-section><span class=secno>2. </span>Sample section</h2>
239+
<h2 id=sample-topic><span class=secno>2. </span> Sample section</h2>
241240

242241
<p>Look at the mark-up in this section for examples. See the <a
243242
href="https://www.w3.org/Style/Group/css3-src/bin/README">documentation</a>
@@ -302,8 +301,8 @@ <h2 id=sample-section><span class=secno>2. </span>Sample section</h2>
302301

303302
<p>A formal definition of a property looks like this:
304303

305-
<h3 id=the-display-model><span class=secno>2.1. </span>Inner Display Model:
306-
the &lsquo;<a href="#display-model"><code
304+
<h3 id=the-display-model><span class=secno>2.1. </span> Inner Display
305+
Model: the &lsquo;<a href="#display-model"><code
307306
class=property>display-model</code></a>&rsquo; property</h3>
308307

309308
<table class=propdef>
@@ -444,18 +443,40 @@ <h3 id=partial><span class=secno>3.2. </span> Partial Implementations</h3>
444443
<h3 id=experimental><span class=secno>3.3. </span> Experimental
445444
Implementations</h3>
446445

447-
<p>To avoid clashes with future CSS features, the CSS specifications
448-
reserve a <a
446+
<p>To avoid clashes with future CSS features, the CSS2.1 specification
447+
reserves a <a
449448
href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
450-
syntax</a> for proprietary property and value extensions to CSS. The CSS
451-
Working Group recommends that experimental implementations of features in
452-
CSS Working Drafts also use vendor-prefixed property or value names. This
453-
avoids any incompatibilities with future changes in the draft. Once a
454-
specification reaches the Candidate Recommendation stage, implementors
455-
should implement the non-prefixed syntax for any feature they consider to
456-
be correctly implemented according to spec.
449+
syntax</a> for proprietary and experimental extensions to CSS.
450+
451+
<p>Prior to a specification reaching the Candidate Recommendation stage in
452+
the W3C process, all implementations of a CSS feature are considered
453+
experimental. The CSS Working Group recommends that implementations use a
454+
vendor-prefixed syntax for such features, including those in W3C Working
455+
Drafts. This avoids incompatibilities with future changes in the draft.
456+
457+
<h3 id=testing><span class=secno>3.4. </span>Non-Experimental
458+
Implementations</h3>
459+
460+
<p>Once a specification reaches the Candidate Recommendation stage,
461+
non-experimental implementations are possible, and implementors should
462+
release an unprefixed implementation of any CR-level feature they can
463+
demonstrate to be correctly implemented according to spec.
464+
465+
<p>To establish and maintain the interoperability of CSS across
466+
implementations, the CSS Working Group requests that non-experimental CSS
467+
renderers submit an implementation report (and, if necessary, the
468+
testcases used for that implementation report) to the W3C before releasing
469+
an unprefixed implementation of any CSS features. Testcases submitted to
470+
W3C are subject to review and correction by the CSS Working Group.
471+
472+
<p>Further information on submitting testcases and implementation reports
473+
can be found from on the CSS Working Group's website at <a
474+
href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
475+
Questions should be directed to the <a
476+
href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
477+
mailing list.
457478

458-
<h3 id=cr-exit-criteria><span class=secno>3.4. </span> CR Exit Criteria</h3>
479+
<h3 id=cr-exit-criteria><span class=secno>3.5. </span> CR Exit Criteria</h3>
459480

460481
<p class=issue>[Change or remove the following CR exit criteria if the spec
461482
is not a module, but, e.g., a Note or a profile. This text was <a
@@ -525,10 +546,10 @@ <h3 class=no-num id=normative-references>Normative references</h3>
525546
<dt id=CSS21>[CSS21]
526547

527548
<dd>Bert Bos; et al. <a
528-
href="http://www.w3.org/TR/2009/CR-CSS2-20090423"><cite>Cascading Style
529-
Sheets Level 2 Revision 1 (CSS&#160;2.1) Specification.</cite></a> 23
530-
April 2009. W3C Candidate Recommendation. (Work in progress.) URL: <a
531-
href="http://www.w3.org/TR/2009/CR-CSS2-20090423">http://www.w3.org/TR/2009/CR-CSS2-20090423</a>
549+
href="http://www.w3.org/TR/2011/REC-CSS2-20110607"><cite>Cascading Style
550+
Sheets Level 2 Revision 1 (CSS&#160;2.1) Specification.</cite></a> 7 June
551+
2011. W3C Recommendation. URL: <a
552+
href="http://www.w3.org/TR/2011/REC-CSS2-20110607">http://www.w3.org/TR/2011/REC-CSS2-20110607</a>
532553
</dd>
533554
<!---->
534555

@@ -574,20 +595,19 @@ <h3 class=no-num id=other-references>Other references</h3>
574595
<dt id=CSS21>[CSS21]
575596

576597
<dd>Bert Bos; et al. <a
577-
href="http://www.w3.org/TR/2009/CR-CSS2-20090423"><cite>Cascading Style
578-
Sheets Level 2 Revision 1 (CSS&#160;2.1) Specification.</cite></a> 23
579-
April 2009. W3C Candidate Recommendation. (Work in progress.) URL: <a
580-
href="http://www.w3.org/TR/2009/CR-CSS2-20090423">http://www.w3.org/TR/2009/CR-CSS2-20090423</a>
598+
href="http://www.w3.org/TR/2011/REC-CSS2-20110607"><cite>Cascading Style
599+
Sheets Level 2 Revision 1 (CSS&#160;2.1) Specification.</cite></a> 7 June
600+
2011. W3C Recommendation. URL: <a
601+
href="http://www.w3.org/TR/2011/REC-CSS2-20110607">http://www.w3.org/TR/2011/REC-CSS2-20110607</a>
581602
</dd>
582603
<!---->
583604

584605
<dt id=CSS3COLOR>[CSS3COLOR]
585606

586607
<dd>Tantek &#199;elik; Chris Lilley; L. David Baron. <a
587-
href="http://www.w3.org/TR/2010/PR-css3-color-20101028"><cite>CSS Color
588-
Module Level 3.</cite></a> 28 October 2010. W3C Proposed Recommendation.
589-
(Work in progress.) URL: <a
590-
href="http://www.w3.org/TR/2010/PR-css3-color-20101028">http://www.w3.org/TR/2010/PR-css3-color-20101028</a>
608+
href="http://www.w3.org/TR/2011/REC-css3-color-20110607"><cite>CSS Color
609+
Module Level 3.</cite></a> 7 June 2011. W3C Recommendation. URL: <a
610+
href="http://www.w3.org/TR/2011/REC-css3-color-20110607">http://www.w3.org/TR/2011/REC-css3-color-20110607</a>
591611
</dd>
592612
<!---->
593613

css-module/Overview.src.html

+46-18
Original file line numberDiff line numberDiff line change
@@ -61,22 +61,23 @@ <h2 class="no-num no-toc" id="contents">Table of contents</h2>
6161

6262
<!--toc-->
6363

64-
<h2>Introduction</h2>
65-
66-
<h3 id="context">Background</h3>
64+
<h2 id="intro">
65+
Introduction</h2>
6766

6867
<p><em>This section is not normative.</em>
6968

7069
<p><var class="issue">Provide background, motivation, etc.</var></p>
7170

72-
<h3 id="placement">Module Interactions</h3>
71+
<h3 id="placement">
72+
Module Interactions</h3>
7373

7474
<p class="issue">Explain, normatively, how this module affects the definition of CSS.</p>
7575

7676
<p>This module replaces and extends the <var class="issue">SUMMARIZE HERE</var>
7777
features defined in [[!CSS21]] sections <var class="issue">W.X and Y.Z</var>.
7878

79-
<h3 id="conventions">Document Conventions</h3>
79+
<h3 id="conventions">
80+
Document Conventions</h3>
8081

8182
<p>Conformance requirements are expressed with a combination of
8283
descriptive assertions and RFC 2119 terminology. The key words “MUST”,
@@ -102,7 +103,8 @@ <h3 id="conventions">Document Conventions</h3>
102103

103104
<p class="note">Note, this is an informative note.</p>
104105

105-
<h3 id="values">Values</h3>
106+
<h3 id="values">
107+
Values</h3>
106108

107109
<p>This specification follows the
108110
<a href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property
@@ -118,7 +120,8 @@ <h3 id="values">Values</h3>
118120
keyword as their property value. For readability it has not been repeated
119121
explicitly.
120122

121-
<h2>Sample section</h2>
123+
<h2 id="sample-topic">
124+
Sample section</h2>
122125

123126
<p>Look at the mark-up in this section for examples. See the <a
124127
href="https://www.w3.org/Style/Group/css3-src/bin/README">documentation</a> for more precise instructions. The
@@ -177,7 +180,8 @@ <h2>Sample section</h2>
177180

178181
<p>A formal definition of a property looks like this:</p>
179182

180-
<h3 id="the-display-model">Inner Display Model: the 'display-model' property</h3>
183+
<h3 id="the-display-model">
184+
Inner Display Model: the 'display-model' property</h3>
181185

182186
<table class=propdef>
183187
<tr>
@@ -287,19 +291,43 @@ <h3 id="partial">
287291
multi-value property declaration: if any value is considered invalid
288292
(as unsupported values must be), CSS requires that the entire declaration
289293
be ignored.</p>
290-
294+
291295
<h3 id="experimental">
292296
Experimental Implementations</h3>
293297

294-
<p>To avoid clashes with future CSS features, the CSS specifications
295-
reserve a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
296-
syntax</a> for proprietary property and value extensions to CSS. The CSS
297-
Working Group recommends that experimental implementations of features in
298-
CSS Working Drafts also use vendor-prefixed property or value names. This
299-
avoids any incompatibilities with future changes in the draft. Once a
300-
specification reaches the Candidate Recommendation stage, implementors
301-
should implement the non-prefixed syntax for any feature they consider to
302-
be correctly implemented according to spec.</p>
298+
<p>To avoid clashes with future CSS features, the CSS2.1 specification
299+
reserves a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
300+
syntax</a> for proprietary and experimental extensions to CSS.
301+
302+
<p>Prior to a specification reaching the Candidate Recommendation stage
303+
in the W3C process, all implementations of a CSS feature are considered
304+
experimental. The CSS Working Group recommends that implementations
305+
use a vendor-prefixed syntax for such features, including those in
306+
W3C Working Drafts. This avoids incompatibilities with future changes
307+
in the draft.
308+
</p>
309+
310+
<h3 id="testing">Non-Experimental Implementations</h3>
311+
312+
<p>Once a specification reaches the Candidate Recommendation stage,
313+
non-experimental implementations are possible, and implementors should
314+
release an unprefixed implementation of any CR-level feature they
315+
can demonstrate to be correctly implemented according to spec.
316+
317+
<p>To establish and maintain the interoperability of CSS across
318+
implementations, the CSS Working Group requests that non-experimental
319+
CSS renderers submit an implementation report (and, if necessary, the
320+
testcases used for that implementation report) to the W3C before
321+
releasing an unprefixed implementation of any CSS features. Testcases
322+
submitted to W3C are subject to review and correction by the CSS
323+
Working Group.
324+
325+
<p>Further information on submitting testcases and implementation reports
326+
can be found from on the CSS Working Group's website at
327+
<a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
328+
Questions should be directed to the
329+
<a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
330+
mailing list.
303331

304332
<h3 id="cr-exit-criteria">
305333
CR Exit Criteria</h3>

0 commit comments

Comments
 (0)