[css-lists] Added some stability issues.

Author: tabatkins

css-lists/Overview.bs

@@ -21,6 +21,11 @@ Abstract: This draft contains the features of CSS level 3 relating to list
 <h2 id='intro'>
 Introduction</h2>
 
+	<p class='issue'><strong>
+		This is an early-stage working draft.
+		None of its contents should be considered suitable for implementation at this point.
+		Please cross-check against CSS 2.1 before implementing anything in this specification.</strong>
+
 	This specification defines the ''::marker'' pseudo-element,
 	the ''list-item'' and ''inline-list-item'' 'display' values that generate markers,
 	and several properties controlling the placement and styling of markers.
@@ -109,7 +114,7 @@ Default Marker Contents: The 'list-style-image' and 'list-style-type' properties
 	Inherited: yes
 	Percentages: n/a
 	Media: visual
-	Computed value: computed value fo the <<image>>, or ''none''
+	Computed value: computed value fo the <<image>>, or ''list-style-image/none''
 	</pre>
 
 	The 'list-style-image' property specifies an image that will be used as the list marker's <i>default contents</i>.
@@ -136,7 +141,7 @@ Default Marker Contents: The 'list-style-image' and 'list-style-type' properties
 
 	<pre class="propdef">
 	Name: list-style-type
-	Value: <<string>> | <<counter-style>> | none
+	Value: <<counter-style>> | <<string>> | none
 	Initial: disc
 	Applies to: <a>list items</a>
 	Inherited: yes
@@ -145,21 +150,21 @@ Default Marker Contents: The 'list-style-image' and 'list-style-type' properties
 	Computed value: specified value
 	</pre>
 
-	When the value of 'list-style-image' is ''none''
+	When the value of 'list-style-image' is ''list-style-image/none''
 	or an <a href="http://www.w3.org/TR/css3-images/#invalid-image">invalid image</a>,
 	the 'list-style-type' property is used to construct the default contents of a list item's marker;
 	otherwise, 'list-style-type' is ignored.
 	The values are defined as follows:
 
 	<dl dfn-type="value" dfn-for="list-style-type">
-		<dt><dfn>&lt;string></dfn>
-		<dd>
-			The <<string>> is used as the list item's marker's <i>default contents</i>.
-
 		<dt><dfn>&lt;counter-style></dfn>
 		<dd>
 			The list item's marker's <i>default contents</i> are that counter style. [[CSS-COUNTER-STYLES-3]]
 
+		<dt><dfn>&lt;string></dfn>
+		<dd>
+			The <<string>> is used as the list item's marker's <i>default contents</i>.
+
 		<dt><dfn>none</dfn>
 		<dd>
 			The list item's marker's <i>default contents</i> are ''none''.
@@ -229,7 +234,7 @@ Marker Position: The 'list-style-position' property</h2>
 	</dl>
 
 	Note: Note that a marker is only generated
-	if the used value of the 'content' property for the ''::marker'' pseudo-element is not ''none''.
+	if the used value of the 'content' property for the ''::marker'' pseudo-element is not ''content/none''.
 
 	<div class=example>
 		For example:
@@ -368,7 +373,7 @@ Markers: The ''::marker'' pseudo-element</h2>
 
 	The ''::marker'' pseudo-element is only created on <i>list items</i>.
 	On any other element,
-	the ''::marker'' pseudo-element's 'content' property must compute to ''none'',
+	the ''::marker'' pseudo-element's 'content' property must compute to ''content/none'',
 	which suppresses its creation.
 
 	<div class="example">
@@ -509,7 +514,7 @@ Generating the value of the 'content' property</h3>
 
 		<dt>''none''
 		<dd>
-			The computed value of the 'content' property is ''none''.
+			The computed value of the 'content' property is ''content/none''.
 	</dl>
 
 	If the computed value of 'content' was an <<image>>,
@@ -538,6 +543,11 @@ Generating the value of the 'content' property</h3>
 <h2 id='positioning-markers'>
 Positioning Markers</h2>
 
+	<p class='issue'><strong>
+		This section is not ready for implementation.
+		It is an unreviewed rough draft that hasn't even been properly checked for Web-compatibility.
+		Feel free to send feedback, but DON'T USE THIS PART OF THE SPEC.</strong>
+
 	This section introduces a new positioning scheme,
 	designed to model the way in which ''list-style-position:outside'' list markers were traditionally positioned in CSS 2.1.
 	Outside list markers now have their positioning defined	in terms of this new value.
@@ -1060,7 +1070,7 @@ Nested Counters</h3>
 Counters in elements that do not generate boxes</h3>
 
 	An element that does not generate a box
-	(for example, an element with 'display' set to ''none'', or a pseudo-element with 'content' set to ''none'')
+	(for example, an element with 'display' set to ''display/none'', or a pseudo-element with 'content' set to ''content/none'')
 	cannot set, reset, or increment  a counter.
 	The counter properties are still valid on such an element,
 	but they must have no effect.