Skip to content

Commit 81d7e5d

Browse files
committed
[css-2015] Rewrite Process section, copied mostly from http://fantasai.inkedblade.net/weblog/2011/inside-csswg/process.
1 parent f323892 commit 81d7e5d

1 file changed

Lines changed: 64 additions & 62 deletions

File tree

css-2015/Overview.bs

Lines changed: 64 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -57,67 +57,6 @@ Introduction {#intro}
5757
and/or the <a href="http://www.w3.org/blog/CSS">CSS Working Group Blog</a>
5858
for any resulting changes, corrections, or clarifications.
5959

60-
<h3 id="w3c-process">The W3C Process and CSS</h3>
61-
62-
<em>This section is non-normative.</em>
63-
64-
In the <a href="http://www.w3.org/2005/10/Process-20051014/">W3C Process</a>,
65-
a Recommendation-track document passes through five levels of stability,
66-
summarized below:
67-
68-
<dl>
69-
<dt>Working Draft (WD)
70-
<dd>
71-
Published during the process of drafting the specification,
72-
the purpose of a public Working Draft is to create a snapshot of
73-
the specification's current state and to solicit input from the
74-
W3C and the public. The document is known to be unstable, and is
75-
often incomplete.
76-
77-
<dt>Last Call Working Draft (LC or LCWD)
78-
<dd>
79-
By publishing a Last Call Working Draft, a working group is
80-
expressing that they consider the spec to be complete and all
81-
issues to be resolved. Publishing a Last Call Working Draft
82-
announces that this specification will move toward Candidate
83-
Recommendation unless significant issues are brought up. The
84-
Last Call period is a last chance for others to submit issues
85-
before the transition to CR.
86-
87-
<dt>Candidate Recommendation (CR)
88-
<dd>
89-
By publishing a Candidate Recommendation, a working group is
90-
expressing that have resolved all known issues and they believe
91-
the spec is ready for implementation.
92-
93-
<dt>Proposed Recommendation (PR)
94-
<dd>
95-
To exit CR and enter this stage, the spec needs a comprehensive
96-
test suite and implementation reports proving that every feature
97-
in the spec is interoperably implemented in at least two shipping
98-
implementations. Entering the Proposed Recommendation stage signals
99-
to the W3C that these requirements have been met. Once the W3C
100-
officially approves the specification, it becomes a Recommendation.
101-
102-
<dt>Recommendation (REC)
103-
<dd>
104-
This is the final stage. At this point there should need to
105-
be no more changes.
106-
</dl>
107-
108-
In the CSSWG's experience, the recommendation track is not linear.
109-
The wider review triggered by an LCWD often results in at least another
110-
working draft, possibly several. More significantly, our experience is
111-
that many specs enter CR twice, because implementation testing often
112-
uncovers significant problems in the spec and thus pushes it back to
113-
working draft. Additionally, fixing even minor problems forces a CR
114-
to re-enter the Working Draft stage. As a result, although the CSSWG
115-
has a clear idea of the stability of the CSS specs, it is very difficult
116-
for someone outside the working group to come to that same understanding
117-
based on a specification's official status. The CSS Working Group's
118-
motivation for creating this document is thus to communicate to others
119-
our understanding of the state of CSS.
120-
12160

12261
<h2 id="css">Cascading Style Sheets (CSS) &mdash; The Official Definition</h2>
12362

@@ -156,6 +95,12 @@ Introduction {#intro}
15695
* plus will-change and CSS3 UI once stable updates are published to TR
15796
</div>
15897

98+
Advisement:
99+
A list of all CSS modules, stable and in-progress,
100+
and their statuses
101+
can be found at the <a href="http://www.w3.org/Style/CSS/current-work">CSS Current Work page</a>.
102+
103+
159104
<h3 id="css-levels">
160105
CSS Levels</h3>
161106

@@ -219,14 +164,71 @@ CSS Levels</h3>
219164
Modules with no <a>CSS Level 2</a> equivalent start at Level 1;
220165
modules that update features that existed in <a>CSS Level 2</a> start at Level 3.
221166

222-
<dt><dfn export>CSS Level 4</dfn>
167+
<dt><dfn export>CSS Level 4</dfn> and beyond
223168
<dd>
224169
There is no CSS Level 4.
225170
Independent modules can reach level 4 or beyond,
226171
but CSS the language no longer has levels.
227172
("CSS Level 3" as a term is used only to differentiate it from the previous monolithic versions.)
228173
</dl>
229174

175+
<h3 id="w3c-process">The W3C Process and CSS</h3>
176+
177+
In the <a href="http://www.w3.org/Consortium/Process/">W3C Process</a>,
178+
a Recommendation-track document passes through three levels of stability,
179+
summarized below:
180+
181+
<dl>
182+
<dt>Working Draft (WD)
183+
<dd>
184+
185+
This is the design phase of a W3C spec.
186+
The WG iterates the spec in response to internal and external feedback.
187+
188+
The first official Working Draft is designated the “First Public Working Draft” (FPWD).
189+
In the CSSWG, publishing FPWD indicates that the Working Group as a whole has agreed to work on the module,
190+
roughly as scoped out and proposed in the editor's draft.
191+
192+
The transition to the next stage is sometimes called “Last Call Working Draft” (LCWD) phase.
193+
The CSSWG transitions Working Drafts once we have resolved all known issues,
194+
and can make no further progress without feedback from building tests and implementations.
195+
196+
This ”Last Call for Comments” sets a deadline for reporting any outstanding issues,
197+
and requires the WG to specially track and address incoming feedback.
198+
The comment-tracking document is the Disposition of Comments (DoC).
199+
It is submitted along with an updated draft for the Director's approval,
200+
to demonstrate wide review and acceptance.
201+
202+
<dt>Candidate Recommendation (CR)
203+
<dd>
204+
This is the testing phase of a W3C spec.
205+
Notably, this phase is about using tests and implementations to test the specification:
206+
it is not about testing the implementations.
207+
This process often reveals more problems with the spec,
208+
and so a Candidate Recommendation will morph over time in response to implementation and testing feedback,
209+
though usually less so than during the design phase (WD).
210+
211+
Demonstration of two correct, independent implementations of each feature is required to exit CR,
212+
so in this phase the WG builds a test suite and generates implementation reports.
213+
214+
The transition to the next stage is “Proposed Recommendation” (PR).
215+
During this phase the W3C Advisory Committee must approve the transition to REC.
216+
217+
<dt>Recommendation (REC)
218+
<dd>
219+
This is the completed state of a W3C spec and represents a maintainance phase.
220+
At this point the WG only maintains an errata document
221+
and occasionally publishes an updated edition that incorporates the errata back into the spec.
222+
</dl>
223+
224+
An <dfn export>Editor's Draft</dfn> is effectively a live copy of the editors’ own working copy.
225+
It may or may not reflect Working Group consensus,
226+
and can at times be in a self-inconsistent state.
227+
(Because the publishing process at W3C is time-consuming and onerous,
228+
the <a>Editor's Draft</a> is usually the best (most up-to-date) reference for a spec.
229+
Efforts are currently underway to reduce the friction of publishing,
230+
so that official drafts will be regularly up-to-date
231+
and <a>Editor's Drafts</a> can return to their original function as scratch space.)
230232

231233
<h2 id="responsible">
232234
Requirements for Responsible Implementation of CSS</h2>

0 commit comments

Comments
 (0)