[css-2015] Edit in the list of specs. TTA and Flexbox = :(

Author: fantasai

css-2015/Overview.bs

@@ -64,37 +64,149 @@ Introduction {#intro}
 	<dfn>Cascading Style Sheets (CSS)</dfn> is defined by the following
 	specifications.
 
-	<ol>
-		<li><a href="http://www.w3.org/TR/CSS2/">CSS Level 2 Revision 1</a>
-				(including errata)
-		<li><a href="http://www.w3.org/TR/css-style-attr/">CSS Style Attributes</a>
-		<li><a href="http://www.w3.org/TR/css3-mediaqueries/">Media Queries Level 3</a>
-		<li><a href="http://www.w3.org/TR/css3-namespace/">CSS Namespaces</a>
-		<li><a href="http://www.w3.org/TR/css3-selectors/">Selectors Level 3</a>
-		<li><a href="http://www.w3.org/TR/css3-color/">CSS Color Level 3</a>
-	</ol>
+	<dl>
+		<dt><a href="http://www.w3.org/TR/CSS2/">CSS Level 2, latest revision</a> (including errata)
+		<dd>
+				This defines the core of CSS, parts of which are overridden by later specifications.
+				We recommend in particular reading <a href="http://www.w3.org/TR/CSS2/intro.html">Chapter 2</a>,
+				which introduces some of the basic concepts of CSS
+				and its design principles.
+
+		<dt><a href="http://www.w3.org/TR/css-syntax-3/">CSS Syntax Level 3</a>
+		<dd>
+			Replaces CSS2&sect;4.1, CSS2&sect;4.1, CSS2&sect;4.2, CSS2&sect;4.4, and CSS2&sect;G,
+			defining how CSS is parsed.
+
+		<dt><a href="http://www.w3.org/TR/css-style-attr/">CSS Style Attributes</a>
+		<dd>
+			Defines how CSS declarations can be embedded in markup attributes.
+
+		<dt><a href="http://www.w3.org/TR/css3-mediaqueries/">Media Queries Level 3</a>
+		<dd>
+			Replaces CSS2&sect;7.3 and expands on the syntax for media-specific styles.
+
+		<dt><a href="http://www.w3.org/TR/css3-conditional/">CSS Conditional Rules Level 3</a>
+		<dd>
+			Replaces CSS2&sect;7.2, updating the definition of ''@media'' rules to allow nesting;
+		  and introduces ''@supports'' rules for feature-support queries.
+
+		<dt><a href="http://www.w3.org/TR/css3-namespace/">CSS Namespaces</a>
+		<dd>
+			Introduces an ''@namespace'' rule to allow namespace-prefixed selectors.
+
+		<dt><a href="http://www.w3.org/TR/css3-selectors/">Selectors Level 3</a>
+		<dd>
+			Replaces CSS2&sect;5 and CSS2&sect;6.4.3, defining an extended range of selectors.
+
+		<dt><a href="http://www.w3.org/TR/css3-cascade/">CSS Cascading and Inheritance Level 3</a>
+		<dd>
+			Replaces CSS2&sect;1.4.3 and CSS2&sect;6
+
+		<dt><a href="http://www.w3.org/TR/css3-transitions/">CSS Transitions Level 1</a>
+		  and <a href="http://www.w3.org/TR/css3-animations/">CSS Animations Level 1</a>
+		<dd>
+			Define mechanisms for transitioning the computed values of CSS properties over time.
+
+			ISSUE: IIRC, these specs have some fairly significant out-of-dateness atm...
+			Should they move to the note below? Or a different note?
+
+		<dt><a href="http://www.w3.org/TR/css3-values/">CSS Values and Units Level 3</a>
+		<dd>
+			Replaces CSS2&sect;1.4.2.1, CSS2&sect;4.3, and CSS2&sect;A.2.1&ndash;3,
+			defining CSS's property definition syntax
+			and expanding its set of units.
 
-	<div class="issue">
-		RESOLVED: Produce the snapshot with list below.
-		Group will review when finished.
-
-		* Everything in REC
-		* Animations L1
-		* Backgrounds and Borders L3,
-		* Cascading and Inheritance L3
-		* Compositing and Blending L1
-		* Conditional L3
-		* Flexible Box Layout L1,
-		* Fonts L3
-		* Images and Replaced Content L3
-		* Multicolumn Layout L1
-		* Syntax L3
-		* Transforms L1
-		* Transitions L1,
-		* Values and Units L3
-		* plus will-change and CSS3 UI once stable updates are published to TR
+		<dt><a href="http://www.w3.org/TR/css3-color/">CSS Color Level 3</a>
+		<dd>
+			Replaces CSS2&sect;4.3.6 and CSS2&sect;14.1, defining an extended range of color values;
+			and introduces the 'opacity' property.
+
+		<dt><a href="http://www.w3.org/TR/css3-background/">CSS Backgrounds and Borders Level 3</a>
+		<dd>
+			Replaces CSS2&sect;8.5 and CSS2&sect;14.2,
+			providing more control of backgrounds and borders,
+			including layered background images,
+			image borders,
+			and drop shadows.
+
+		<dt><a href="http://www.w3.org/TR/css3-images/">CSS Image Values and Replaced Content Level 3</a>
+		<dd>
+			Provides a new foundation text for the sizing of replaced elements (such as images),
+			adds additional controls to their sizing and orientation,
+			and introduces syntax for gradients as images images in CSS.
+
+		<dt><a href="http://www.w3.org/TR/css-fonts-3/">CSS Fonts Level 3</a>
+		<dd>
+			Replaces CSS2&sect;15
+			and provides more control over font choice and feature selection.
+
+		<dt><a href="http://www.w3.org/TR/css3-multicol/">CSS Multi-column Layout Level 1</a>
+		<dd>
+			Introduces multi-column flows to CSS layout.
+
+		<dt><a href="http://www.w3.org/TR/css-flexbox-1/">CSS Flexible Box Module Level 1</a>
+		<dd>
+			Introduces a new layout model for CSS.
+
+			ISSUE: This spec isn't very stable yet... (We all wish it was though.) Should it move to the note below?
+
+		<dt><a href="http://www.w3.org/TR/css3-ui/">CSS User Interface Module Level 3</a>
+		<dd>
+			Replaces CSS2&sect;18.1 and CSS2&sect;18.4,
+			defining 'cursor', 'outline', and several new CSS features that also enhance the user interface.
+
+		<dt><a href="http://www.w3.org/TR/css3-transforms/">CSS Transforms Level 1</a>
+		<dd>
+			Introduces graphical transformations to CSS.
+
+			ISSUE: Is this thing actually up-to-date and referenceable?
+
+		<dt><a href="http://www.w3.org/TR/compositing-1/">CSS Compositing and Blending Level 1</a>
+		<dd>
+			Defines the compositing and blending of overlaid content
+			and introduces features to control their modes.
+	</dl>
+
+	Issue: Add will-change once it's pushed to CR
+
+	<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="http://www.w3.org/TR/css-counter-styles-3/">CSS Counter Styles Level 3</a>
+			<dd>
+				Expands the possible values of <<counter-style>>
+				and provides an ''@counter-style'' syntax for customized counter styles.
+
+			<dt><a href="http://www.w3.org/TR/css-masking-1/">CSS Masking Level 1</a>
+			<dd>
+				Replaces CSS2&sect;11.1.2
+				and introduces more powerful ways of clipping and masking content.
+
+			<dt><a href="http://www.w3.org/TR/css-shapes-1/">CSS Shapes Module Level 1</a>
+			<dd>
+				Extends floats to effect non-rectangular wrapping shapes.
+
+			<dt><a href="http://www.w3.org/TR/css-text-decor-3/">CSS Text Decoration Level 3</a>
+			<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="http://www.w3.org/TR/css-speech/">CSS Speech Module Level 1</a>
+			<dd>
+				Replaces CSS2&sect;A,
+				overhauling the (non-normative) speech rendering chapter.
+		</dl>
+
+		We hope to incorporate them into a future snapshot.
 	</div>
 
+	ISSUE: Should we have a section for "These specifications are widely implemented, but their specifications are out-of-sync with reality" for Transitions/Transforms/Animations/Flexbox?
+
 	Advisement:
 	A list of all CSS modules, stable and in-progress,
 	and their statuses
@@ -370,6 +482,9 @@ Requirements for Responsible Implementation of CSS</h2>
 
 <em>These sections are non-normative.</em>
 
+ISSUE: Incorporate all the rest of the specs into these indices.
+(These only include the 2010 snapshot content.)
+
 <h3 id="properties">Property Index</h3>
 
 <table class="proptable">