updates from review.

Author: rachelandrew

css-display-4/Overview.bs

@@ -1153,7 +1153,7 @@ Reading Order: the 'reading-order-items' property</h2>
 
 	<pre class='propdef'>
 	Name: reading-order-items
-	Value: normal from-order? | flex [ visual | flow ] | grid [ rows | columns ]
+	Value: normal | flex-visual | flex-flow | grid-rows | grid-columns | grid-order
 	Initial: normal
 	Applies to: flex and grid containers
 	Inherited: no
@@ -1165,47 +1165,44 @@ Reading Order: the 'reading-order-items' property</h2>
 	elements in a flex or grid layout are rendered to speech
 	or are navigated to when using (linear) sequential navigation methods.
 
-	It takes one or more keyword values. Values are defined as follows:
+	It takes one keyword value. Values are defined as follows:
 
 	<dl dfn-for=reading-order-items dfn-type=value>
 		<dt><dfn>normal</dfn>
 		<dd>
 			Follow the order of elements in the DOM.
-		<dt><dfn>normal from-order</dfn>
-		<dd>
-			Follows the [=order-modified document order=].
-			Therefore, as 'normal' unless the 'order'
-			property has been used to change the order of items.
-		<dt><dfn>flex visual</dfn>
+		<dt><dfn>flex-visual</dfn>
 		<dd>
 			Only takes effect on flex containers. 
 			Follows the visual reading order of flex items,
 			taking the writing mode into account.
 			Therefore, a document in English, with a 'flex-direction' of 'row-reverse'
 			and 'reading-order-items' of 'flex visual'
 			would have a reading order of left to right.
-		<dt><dfn>flex flow</dfn>
+		<dt><dfn>flex-flow</dfn>
 		<dd>
 			Only takes effect on flex containers.
 			Follows the 'flex-flow' direction.
-		<dt><dfn>grid rows</dfn>
+		<dt><dfn>grid-rows</dfn>
 		<dd>
 			Only takes effect on grid containers.
 			Follows the visual order of grid items by row,
 			taking the writing mode into account.
-		<dt><dfn>grid columns</dfn>
+		<dt><dfn>grid-columns</dfn>
 		<dd>
 			Only takes effect on grid containers.
 			Follows the visual order of grid items by column,
 			taking the writing mode into account.
+		<dt><dfn>grid-order</dfn>
+		<dd>
+			Follows the [=order-modified document order=].
+			Therefore, as 'normal' unless the 'order'
+			property has been used to change the order of items.
 	</dl>
 
-	ISSUE: <a href="https://github.com/w3c/csswg-drafts/issues/8589#issuecomment-1690330738">As raised in a comment by fantasai</a>,
-	do we need the multiple keywords, or should we hyphenate?
-
 	<div class='example'>
 		In this example, there are three flex items displayed as a row,
-		The 'reading-order-items' property has a value of 'flex visual'.
+		The 'reading-order-items' property has a value of 'flex-visual'.
 		The 'flex-direction' property is 'row-reverse'.
 		The reading order of these items is therefore
 		"Item 3", "Item 2", "Item 1", reading from left to right.
@@ -1222,15 +1219,15 @@ Reading Order: the 'reading-order-items' property</h2>
         .wrapper {
             display: flex;
             flex-direction: row-reverse;
-            reading-order-items: flex visual;
+            reading-order-items: flex-visual;
         }
 		</pre>
 	</div>
 
 	<div class='example'>
 		In this example there are four grid items,
 		placed on a grid and displayed visually out of DOM order.
-		The 'reading-order-items' property has a value of 'grid rows',
+		The 'reading-order-items' property has a value of 'grid-rows',
 		and the document is in English.
 		The reading order of these items is therefore
 		"Item 4", "Item 2", "Item 3", "Item 1".
@@ -1250,7 +1247,7 @@ Reading Order: the 'reading-order-items' property</h2>
             grid-template-columns: repeat(3, 150px);
             grid-template-areas: "d b b"
                                  "c c a";  
-            reading-order-items: grid rows;
+            reading-order-items: grid-rows;
         }
 
         .a { grid-area: a; }
@@ -1263,12 +1260,12 @@ Reading Order: the 'reading-order-items' property</h2>
 	The 'reading-order-items' property affects neither layout nor painting order
 	and therefore has no effect on rendering to the visual [=canvas=].
 
-	When using a 'flex' or 'grid' keyword value,
+	When using a 'flex-*' or 'grid-*' keyword value,
 	the 'order' property is taken into account.
 
 	<div class='example'>
 		In this example, there are three flex items displayed as a row,
-		The 'reading-order-items' property has a value of 'flex flow'.
+		The 'reading-order-items' property has a value of 'flex-flow'.
 		The third item in the DOM has 'order=-1'.
 		The reading order of these items is therefore
 		"Item 3", "Item 1", "Item 2".
@@ -1288,7 +1285,7 @@ Reading Order: the 'reading-order-items' property</h2>
 
         .wrapper {
             display: flex;
-            reading-order-items: flex flow;
+            reading-order-items: flex-flow;
         }
 		</pre>
 	</div>
@@ -2144,8 +2141,8 @@ Additions since Level 3</h3>
 
 	The following features were added since <a href="https://www.w3.org/TR/css-display-3/">CSS Display Module Level 3</a>:
 
-	* the 'layout-order' and 'reading-order' [=longhand properties=] of 'order'
-		(<a href="https://github.com/w3c/csswg-drafts/issues/7387#issuecomment-1217193918">Issue 7387</a>)
+	* the 'reading-order-items' property 
+		(<a href="https://github.com/w3c/csswg-drafts/issues/8589#issuecomment-1721504153">Issue 8589</a>)
 	* the ability to animate 'display'
 
 <h2 id="priv" class="no-num">