[css-2020] Reoranize document sections, as per w3c#4715 (comment)

Author: frivoal

css-2020/Overview.bs

@@ -128,7 +128,16 @@ Background: The W3C Process and CSS</h3>
 	and <a>Editor's Drafts</a> can return to their original function as scratch space.)
 
 
-<h2 id="css">Cascading Style Sheets (CSS) &mdash; The Official Definition</h2>
+<h2 id=module-classification>
+Classification of CSS Specifications</h2>
+
+	Advisement:
+	A list of all CSS modules, stable and in-progress,
+	and their statuses
+	can be found at the <a href="http://www.w3.org/Style/CSS/current-work">CSS Current Work page</a>.
+
+
+<h3 id="css">Cascading Style Sheets (CSS) &mdash; The Official Definition</h3>
 
 	As of 2020,
 	<dfn export>Cascading Style Sheets (CSS)</dfn> is defined by the following
@@ -283,133 +292,128 @@ Background: The W3C Process and CSS</h3>
 			or to cause the animation to move in discrete steps producing robot-like movement.
 	</dl>
 
-	<div class="note">
-		The following modules are widely deployed with <a>rough interoperability</a>,
-		but the details are not fully worked out
-		and they need more testing and bugfixing.
-
-		<dl>
-			<dt><a href="https://www.w3.org/TR/css3-transitions/">CSS Transitions Level 1</a>
-			  [[CSS3-TRANSITIONS]]
-			  and <a href="https://www.w3.org/TR/css3-animations/">CSS Animations Level 1</a>
-			  [[CSS3-ANIMATIONS]].
-			<dd>
-				Define mechanisms for transitioning the computed values of CSS properties over time.
-
-			<dt><a href="https://www.w3.org/TR/css-grid-1/">CSS Grid Layout Module Level 1</a>
-			  [[!CSS-GRID-1]]
-			<dd>
-				Defines a two-dimensional grid-based layout system,
-				optimized for user interface design.
-				In the grid layout model, the children of a grid container
-				can be positioned into arbitrary slots in a predefined flexible or fixed-size layout grid.
-
-			<dt><a href="https://www.w3.org/TR/css-text-3/">CSS Text Module Level 3</a>
-			  [[CSS-TEXT-3]]
-			<dd>
-				Defines properties for text manipulation and specifies their processing model.
-				It covers line breaking, justification and alignment, white space handling, and text transformation.
-
-			<dt><a href="https://www.w3.org/TR/css-will-change-1/">CSS Will Change Level 1</a>
-			  [[CSS-WILL-CHANGE-1]]
-			<dd>
-				Introduces a performance hint property called 'will-change'.
-
-			<dt><a href="https://www.w3.org/TR/filter-effects-1/">Filter Effects Module Level 1</a>
-			  [[FILTER-EFFECTS-1]]
-			<dd>
-				Filter effects are a way of processing an element’s rendering before it is displayed in the document.
-		</dl>
+<h3 id=rough-interop>
+Modules with Rough Interoperability</h3>
 
-	</div>
+	The following modules are widely deployed with <a>rough interoperability</a>,
+	but the details are not fully worked out
+	and they need more testing and bugfixing.
+	We hope to incorporate them into the [[#css|official definition of CSS]] in a future snapshot.
 
-	<div class="note">
-		The following modules have completed design work,
-		and are fairly stable,
-		but have not received much testing and implementation experience yet:
-
-		<dl>
-			<dt><a href="https://www.w3.org/TR/css-counter-styles-3/">CSS Counter Styles Level 3</a>
-			  [[CSS-COUNTER-STYLES-3]]
-			<dd>
-				Expands the possible values of <<counter-style>>
-				and provides an ''@counter-style'' syntax for customized counter styles.
-
-			<dt><a href="https://www.w3.org/TR/css-masking-1/">CSS Masking Level 1</a>
-			  [[CSS-MASKING-1]]
-			<dd>
-				Replaces CSS2&sect;11.1.2
-				and introduces more powerful ways of clipping and masking content.
-
-			<dt><a href="https://www.w3.org/TR/css-shapes-1/">CSS Shapes Module Level 1</a>
-			  [[CSS-SHAPES-1]]
-			<dd>
-				Extends floats to effect non-rectangular wrapping shapes.
-
-			<dt><a href="https://www.w3.org/TR/css-text-decor-3/">CSS Text Decoration Level 3</a>
-			  [[CSS-TEXT-DECOR-3]]
-			<dd>
-				Replaces CSS2&sect;16.3,
-				providing more control over text decoration lines
-				and adding the ability to specify text emphasis marks
-				and text shadows.
-
-			<dt><a href="https://www.w3.org/TR/css3-speech/">CSS Speech Module Level 1</a>
-			  [[CSS3-SPEECH]]
-			<dd>
-				Replaces CSS2&sect;A,
-				overhauling the (non-normative) speech rendering chapter.
-
-			<dt><a href="https://www.w3.org/TR/css-align-3/">CSS Box Alignment Module Level 3</a>
-			  [[CSS-ALIGN-3]]
-			<dd>
-				Contains the features of CSS relating to the alignment of boxes
-				within their containers in the various CSS box layout models:
-				block layout, table layout, flex layout, and grid layout.
-
-			<dt><a href="https://www.w3.org/TR/css-break-3/">CSS Fragmentation Module Level 3</a>
-			  [[CSS-BREAK-3]]
-			<dd>
-				Describes the fragmentation model that partitions a flow into pages, columns, or regions.
-
-			<dt><a href="https://www.w3.org/TR/css-scroll-snap-1/">CSS Scroll Snap Module Level 1</a>
-			  [[CSS-SCROLL-SNAP-1]]
-			<dd>
-				Contains features to control panning and scrolling behavior with “snap positions”.
-
-			<dt><a href="https://www.w3.org/TR/mediaqueries-4/">Media Queries Level 4</a>
-			  [[MEDIAQUERIES-4]]
-			<dd>
-				Extends and supersedes [[CSS3-MEDIAQUERIES]], expanding the syntax, deprecating most media types,
-				and introducing new media features.
-
-			<dt><a href="https://www.w3.org/TR/css-writing-modes-4/">CSS Writing Modes Level 4</a>
-			  [[CSS-WRITING-MODES-4]]
-			<dd>
-				Extends and supersedes [[CSS-WRITING-MODES-3]],
-				adding more options for vertical writing.
-
-			<dt><a href="https://www.w3.org/TR/css-display-3/">CSS Display Module Level 3</a>
-			  [[CSS-DISPLAY-3]]
-			<dd>
-				Describes how the CSS formatting box tree is generated
-				from the document element tree
-				and defines the display property that controls it.
-
-			<dt><a href="https://www.w3.org/TR/css-font-loading/">CSS Font Loading Module Level 3</a>
-			  [[CSS-FONT-LOADING-3]]
-			<dd>
-				Describes events and interfaces used for dynamically loading font resources.
-		</dl>
-
-		We hope to incorporate them into a future snapshot.
-	</div>
+	<dl>
+		<dt><a href="https://www.w3.org/TR/css3-transitions/">CSS Transitions Level 1</a>
+		  [[CSS3-TRANSITIONS]]
+		  and <a href="https://www.w3.org/TR/css3-animations/">CSS Animations Level 1</a>
+		  [[CSS3-ANIMATIONS]].
+		<dd>
+			Define mechanisms for transitioning the computed values of CSS properties over time.
 
-	Advisement:
-	A list of all CSS modules, stable and in-progress,
-	and their statuses
-	can be found at the <a href="http://www.w3.org/Style/CSS/current-work">CSS Current Work page</a>.
+		<dt><a href="https://www.w3.org/TR/css-grid-1/">CSS Grid Layout Module Level 1</a>
+		  [[!CSS-GRID-1]]
+		<dd>
+			Defines a two-dimensional grid-based layout system,
+			optimized for user interface design.
+			In the grid layout model, the children of a grid container
+			can be positioned into arbitrary slots in a predefined flexible or fixed-size layout grid.
+
+		<dt><a href="https://www.w3.org/TR/css-text-3/">CSS Text Module Level 3</a>
+		  [[CSS-TEXT-3]]
+		<dd>
+			Defines properties for text manipulation and specifies their processing model.
+			It covers line breaking, justification and alignment, white space handling, and text transformation.
+
+		<dt><a href="https://www.w3.org/TR/css-will-change-1/">CSS Will Change Level 1</a>
+		  [[CSS-WILL-CHANGE-1]]
+		<dd>
+			Introduces a performance hint property called 'will-change'.
+
+		<dt><a href="https://www.w3.org/TR/filter-effects-1/">Filter Effects Module Level 1</a>
+		  [[FILTER-EFFECTS-1]]
+		<dd>
+			Filter effects are a way of processing an element’s rendering before it is displayed in the document.
+	</dl>
+
+<h3 id=fairly-stable>
+Fairly Stable Modules with limited implementation experience</h3>
+
+	The following modules have completed design work,
+	and are fairly stable,
+	but have not received much testing and implementation experience yet.
+	We hope to incorporate them into the [[#css|official definition of CSS]] in a future snapshot.
 
+	<dl>
+		<dt><a href="https://www.w3.org/TR/css-counter-styles-3/">CSS Counter Styles Level 3</a>
+		  [[CSS-COUNTER-STYLES-3]]
+		<dd>
+			Expands the possible values of <<counter-style>>
+			and provides an ''@counter-style'' syntax for customized counter styles.
+
+		<dt><a href="https://www.w3.org/TR/css-masking-1/">CSS Masking Level 1</a>
+		  [[CSS-MASKING-1]]
+		<dd>
+			Replaces CSS2&sect;11.1.2
+			and introduces more powerful ways of clipping and masking content.
+
+		<dt><a href="https://www.w3.org/TR/css-shapes-1/">CSS Shapes Module Level 1</a>
+		  [[CSS-SHAPES-1]]
+		<dd>
+			Extends floats to effect non-rectangular wrapping shapes.
+
+		<dt><a href="https://www.w3.org/TR/css-text-decor-3/">CSS Text Decoration Level 3</a>
+		  [[CSS-TEXT-DECOR-3]]
+		<dd>
+			Replaces CSS2&sect;16.3,
+			providing more control over text decoration lines
+			and adding the ability to specify text emphasis marks
+			and text shadows.
+
+		<dt><a href="https://www.w3.org/TR/css3-speech/">CSS Speech Module Level 1</a>
+		  [[CSS3-SPEECH]]
+		<dd>
+			Replaces CSS2&sect;A,
+			overhauling the (non-normative) speech rendering chapter.
+
+		<dt><a href="https://www.w3.org/TR/css-align-3/">CSS Box Alignment Module Level 3</a>
+		  [[CSS-ALIGN-3]]
+		<dd>
+			Contains the features of CSS relating to the alignment of boxes
+			within their containers in the various CSS box layout models:
+			block layout, table layout, flex layout, and grid layout.
+
+		<dt><a href="https://www.w3.org/TR/css-break-3/">CSS Fragmentation Module Level 3</a>
+		  [[CSS-BREAK-3]]
+		<dd>
+			Describes the fragmentation model that partitions a flow into pages, columns, or regions.
+
+		<dt><a href="https://www.w3.org/TR/css-scroll-snap-1/">CSS Scroll Snap Module Level 1</a>
+		  [[CSS-SCROLL-SNAP-1]]
+		<dd>
+			Contains features to control panning and scrolling behavior with “snap positions”.
+
+		<dt><a href="https://www.w3.org/TR/mediaqueries-4/">Media Queries Level 4</a>
+		  [[MEDIAQUERIES-4]]
+		<dd>
+			Extends and supersedes [[CSS3-MEDIAQUERIES]], expanding the syntax, deprecating most media types,
+			and introducing new media features.
+
+		<dt><a href="https://www.w3.org/TR/css-writing-modes-4/">CSS Writing Modes Level 4</a>
+		  [[CSS-WRITING-MODES-4]]
+		<dd>
+			Extends and supersedes [[CSS-WRITING-MODES-3]],
+			adding more options for vertical writing.
+
+		<dt><a href="https://www.w3.org/TR/css-display-3/">CSS Display Module Level 3</a>
+		  [[CSS-DISPLAY-3]]
+		<dd>
+			Describes how the CSS formatting box tree is generated
+			from the document element tree
+			and defines the display property that controls it.
+
+		<dt><a href="https://www.w3.org/TR/css-font-loading/">CSS Font Loading Module Level 3</a>
+		  [[CSS-FONT-LOADING-3]]
+		<dd>
+			Describes events and interfaces used for dynamically loading font resources.
+	</dl>
 
 <h3 id="css-levels">
 CSS Levels</h3>