Skip to content

Commit 511ee04

Browse files
committed
[css-2020] Improve module descriptions.
1 parent f42125b commit 511ee04

1 file changed

Lines changed: 41 additions & 34 deletions

File tree

css-2020/Overview.bs

Lines changed: 41 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -147,16 +147,16 @@ Classification of CSS Specifications</h2>
147147
<dt><a href="https://www.w3.org/TR/CSS2/">CSS Level 2, latest revision</a> (including errata)
148148
[[!CSS2]]
149149
<dd>
150-
This defines the core of CSS, parts of which are overridden by later specifications.
151-
We recommend in particular reading <a href="https://www.w3.org/TR/CSS2/intro.html">Chapter 2</a>,
152-
which introduces some of the basic concepts of CSS
153-
and its design principles.
150+
This defines the core of CSS, parts of which are overridden by later specifications.
151+
We recommend in particular reading <a href="https://www.w3.org/TR/CSS2/intro.html">Chapter 2</a>,
152+
which introduces some of the basic concepts of CSS
153+
and its design principles.
154154

155155
<dt><a href="https://www.w3.org/TR/css-syntax-3/">CSS Syntax Level 3</a>
156156
[[!CSS-SYNTAX-3]]
157157
<dd>
158158
Replaces CSS2&sect;4.1, CSS2&sect;4.2, CSS2&sect;4.4, and CSS2&sect;G,
159-
defining how CSS is parsed.
159+
redefining how CSS is parsed.
160160

161161
<dt><a href="https://www.w3.org/TR/css-style-attr/">CSS Style Attributes</a>
162162
[[!CSS-STYLE-ATTR]]
@@ -171,8 +171,9 @@ Classification of CSS Specifications</h2>
171171
<dt><a href="https://www.w3.org/TR/css-conditional-1/">CSS Conditional Rules Level 3</a>
172172
[[!CSS-CONDITIONAL-1]]
173173
<dd>
174-
Replaces CSS2&sect;7.2, updating the definition of ''@media'' rules to allow nesting,
175-
and introduces ''@supports'' rules for feature-support queries.
174+
Extends and supersedes CSS2&sect;7.2,
175+
updating the definition of ''@media'' rules to allow nesting
176+
and introducing the ''@supports'' rule for feature-support queries.
176177

177178
<dt><a href="https://www.w3.org/TR/css-selectors-3/">Selectors Level 3</a>
178179
[[!SELECTORS-3]]
@@ -187,14 +188,14 @@ Classification of CSS Specifications</h2>
187188
<dt><a href="https://www.w3.org/TR/css-cascade-4/">CSS Cascading and Inheritance Level 4</a>
188189
[[!CSS-CASCADE-4]]
189190
<dd>
190-
Replaces CSS2&sect;1.4.3 and CSS2&sect;6, as well as [[CSS-CASCADE-3]].
191+
Extends and supersedes CSS2&sect;1.4.3 and CSS2&sect;6, as well as [[CSS-CASCADE-3]].
191192
Describes how to collate style rules and assign values to all properties on all elements.
192193
By way of cascading and inheritance, values are propagated for all properties on all elements.
193194

194195
<dt><a href="https://www.w3.org/TR/css-values-3/">CSS Values and Units Level 3</a>
195196
[[!CSS-VALUES-3]]
196197
<dd>
197-
Replaces CSS2&sect;1.4.2.1, CSS2&sect;4.3, and CSS2&sect;A.2.1&ndash;3,
198+
Extends and supersedes CSS2&sect;1.4.2.1, CSS2&sect;4.3, and CSS2&sect;A.2.1&ndash;3,
198199
defining CSS's property definition syntax
199200
and expanding its set of units.
200201

@@ -212,30 +213,30 @@ Classification of CSS Specifications</h2>
212213
<dt><a href="https://www.w3.org/TR/css-color-3/">CSS Color Level 3</a>
213214
[[!CSS-COLOR-3]]
214215
<dd>
215-
Replaces CSS2&sect;4.3.6, CSS2&sect;14.1, and CSS2&sect;18.2,
216-
defining an extended range of color values.
216+
Extends and supersedes CSS2&sect;4.3.6, CSS2&sect;14.1, and CSS2&sect;18.2,
217+
introducing an extended range of color values.
217218
Also introduces the 'opacity' property.
218219

219220
<dt><a href="https://www.w3.org/TR/css-backgrounds-3/">CSS Backgrounds and Borders Level 3</a>
220221
[[!CSS-BACKGROUNDS-3]]
221222
<dd>
222-
Replaces CSS2&sect;8.5 and CSS2&sect;14.2,
223+
Extends and supersedes CSS2&sect;8.5 and CSS2&sect;14.2,
223224
providing more control of backgrounds and borders,
224225
including layered background images,
225226
image borders,
226227
and drop shadows.
227228

228-
<dt><a href="https://www.w3.org/TR/css-images-3/">CSS Image Values and Replaced Content Level 3</a>
229+
<dt><a href="https://www.w3.org/TR/css-images-3/">CSS Images Level 3</a>
229230
[[!CSS-IMAGES-3]]
230231
<dd>
231-
Provides a new foundation text for the sizing of replaced elements (such as images),
232-
adds additional controls to their sizing and orientation,
233-
and introduces syntax for gradients as images in CSS.
232+
Redefines and incorporates the external 2D image value type,
233+
introduces native 2D gradients,
234+
and adds additional controls for replaced element sizing and rendering.
234235

235236
<dt><a href="https://www.w3.org/TR/css-fonts-3/">CSS Fonts Level 3</a>
236237
[[!CSS-FONTS-3]]
237238
<dd>
238-
Replaces CSS2&sect;15
239+
Extends and supersedes CSS2&sect;15
239240
and provides more control over font choice and feature selection.
240241

241242
<dt><a href="https://www.w3.org/TR/css-writing-modes-3/">CSS Writing Modes Level 3</a>
@@ -245,6 +246,7 @@ Classification of CSS Specifications</h2>
245246
such as left-to-right (e.g. Latin or Indic),
246247
right-to-left (e.g. Hebrew or Arabic),
247248
bidirectional (e.g. mixed Latin and Arabic) and vertical (e.g. Asian scripts).
249+
Replaces and extends CSS2&sect;8.6 and &sect;9.10.
248250

249251
<dt><a href="https://www.w3.org/TR/css-multicol-1/">CSS Multi-column Layout Level 1</a>
250252
[[!CSS-MULTICOL-1]]
@@ -259,20 +261,20 @@ Classification of CSS Specifications</h2>
259261
<dt><a href="https://www.w3.org/TR/css-ui-3/">CSS User Interface Module Level 3</a>
260262
[[!CSS-UI-3]]
261263
<dd>
262-
Replaces CSS2&sect;18.1 and CSS2&sect;18.4,
264+
Extends and supersedes CSS2&sect;18.1 and CSS2&sect;18.4,
263265
defining 'cursor', 'outline', and several new CSS features that also enhance the user interface.
264266

265267
<dt><a href="https://www.w3.org/TR/css-contain-1/">CSS Containment Module Level 1</a>
266268
[[!CSS-CONTAIN-1]]
267269
<dd>
268-
Describes the 'contain' property,
269-
which indicates that the element’s subtree is independent of the rest of the page.
270-
This enables heavy optimizations by user agents when used well.
270+
Introduces the 'contain' property,
271+
which enforces the independent CSS processing of an element’s subtree
272+
in order to enable heavy optimizations by user agents when used well.
271273

272274
<dt><a href="https://www.w3.org/TR/css-transforms-1/">CSS Transforms Level 1</a>
273275
[[!CSS-TRANSFORMS-1]]
274276
<dd>
275-
Introduces graphical transformations to CSS.
277+
Introduces coordinate-based graphical transformations to CSS.
276278

277279
<dt><a href="https://www.w3.org/TR/compositing-1/">CSS Compositing and Blending Level 1</a>
278280
[[!COMPOSITING]]
@@ -303,15 +305,17 @@ Fairly Stable Modules with limited implementation experience</h3>
303305
<dt><a href="https://www.w3.org/TR/mediaqueries-4/">Media Queries Level 4</a>
304306
[[MEDIAQUERIES-4]]
305307
<dd>
306-
Extends and supersedes [[CSS3-MEDIAQUERIES]], expanding the syntax, deprecating most media types,
308+
Extends and supersedes [[CSS3-MEDIAQUERIES]],
309+
expanding the syntax, deprecating most media types,
307310
and introducing new media features.
308311

309312
<dt><a href="https://www.w3.org/TR/css-display-3/">CSS Display Module Level 3</a>
310313
[[CSS-DISPLAY-3]]
311314
<dd>
312-
Describes how the CSS formatting box tree is generated
315+
Replaces CSS2&sect;9.1.2, &sect;9.2.1 (but not &sect;9.2.1.1), &sect;9.2.2 (but not &sect;9.2.2.1), &sect;9.2.3, and &sect;9.2.4 (and lays the foundations for replacing &sect;9.7),
316+
defining how the CSS formatting box tree is generated
313317
from the document element tree
314-
and defines the display property that controls it.
318+
and defining the 'display' property that controls it.
315319

316320
<dt><a href="https://www.w3.org/TR/css-writing-modes-4/">CSS Writing Modes Level 4</a>
317321
[[CSS-WRITING-MODES-4]]
@@ -331,30 +335,33 @@ Fairly Stable Modules with limited implementation experience</h3>
331335
<dt><a href="https://www.w3.org/TR/css-break-3/">CSS Fragmentation Module Level 3</a>
332336
[[CSS-BREAK-3]]
333337
<dd>
334-
Describes the fragmentation model that partitions a flow into pages, columns, or regions.
338+
Describes the fragmentation model that partitions a flow into pages, columns, or regions
339+
and defines properties that control it.
340+
Extends and supersedes CSS2&sect;13.3.
335341

336342
<dt><a href="https://www.w3.org/TR/css-align-3/">CSS Box Alignment Module Level 3</a>
337343
[[CSS-ALIGN-3]]
338344
<dd>
339-
Contains the features of CSS relating to the alignment of boxes
345+
Introduces properties to control the alignment of boxes
340346
within their containers in the various CSS box layout models:
341347
block layout, table layout, flex layout, and grid layout.
342348

343349
<dt><a href="https://www.w3.org/TR/css-shapes-1/">CSS Shapes Module Level 1</a>
344350
[[CSS-SHAPES-1]]
345351
<dd>
346-
Extends floats to effect non-rectangular wrapping shapes.
352+
Extends floats (CSS2&sect;9.5) to effect non-rectangular wrapping shapes.
347353

348354
<dt><a href="https://www.w3.org/TR/css-text-3/">CSS Text Module Level 3</a>
349355
[[CSS-TEXT-3]]
350356
<dd>
351-
Defines properties for text manipulation and specifies their processing model.
357+
Extends and supersedes CSS2&sect;16 excepting &sect;16.2,
358+
defining properties for text manipulation and specifying their processing model.
352359
It covers line breaking, justification and alignment, white space handling, and text transformation.
353360

354361
<dt><a href="https://www.w3.org/TR/css-text-decor-3/">CSS Text Decoration Level 3</a>
355362
[[CSS-TEXT-DECOR-3]]
356363
<dd>
357-
Replaces CSS2&sect;16.3,
364+
Extends and supersedes CSS2&sect;16.3,
358365
providing more control over text decoration lines
359366
and adding the ability to specify text emphasis marks
360367
and text shadows.
@@ -397,12 +404,12 @@ Modules with Rough Interoperability</h3>
397404
and <a href="https://www.w3.org/TR/css-animations-1/">CSS Animations Level 1</a>
398405
[[CSS-ANIMATIONS-1]].
399406
<dd>
400-
Define mechanisms for transitioning the computed values of CSS properties over time.
407+
Introduces mechanisms for transitioning the computed values of CSS properties over time.
401408

402409
<dt><a href="https://www.w3.org/TR/css-grid-1/">CSS Grid Layout Module Level 1</a>
403410
[[!CSS-GRID-1]]
404411
<dd>
405-
Defines a two-dimensional grid-based layout system,
412+
Introduces a two-dimensional grid-based layout system,
406413
optimized for user interface design.
407414
In the grid layout model, the children of a grid container
408415
can be positioned into arbitrary slots in a predefined flexible or fixed-size layout grid.
@@ -415,12 +422,12 @@ Modules with Rough Interoperability</h3>
415422
<dt><a href="https://www.w3.org/TR/filter-effects-1/">Filter Effects Module Level 1</a>
416423
[[FILTER-EFFECTS-1]]
417424
<dd>
418-
Filter effects are a way of processing an element’s rendering before it is displayed in the document.
425+
Introduces filter effects as a way of processing an element’s rendering before it is displayed in the document.
419426

420427
<dt><a href="https://www.w3.org/TR/css-font-loading/">CSS Font Loading Module Level 3</a>
421428
[[CSS-FONT-LOADING-3]]
422429
<dd>
423-
Describes events and interfaces used for dynamically loading font resources.
430+
Introduces events and interfaces used for dynamically loading font resources.
424431
</dl>
425432

426433
<h3 id="css-levels">

0 commit comments

Comments
 (0)