[css-flexbox-1] Make note about initial vs default flex shorthand component values more obvious. #6639

fantasai · fantasai · commit ef78972c3944 · 2022-08-18T18:15:51.000-04:00
diff --git a/css-flexbox-1/Overview.bs b/css-flexbox-1/Overview.bs
@@ -1518,6 +1518,13 @@ The 'flex' Shorthand</h3>
 	If a box is not a <a>flex item</a>,
 	'flex' has no effect.
 
+	Note: The initial values of the 'flex' longhands are equivalent to
+	<a class="css-code" href="#flex-initial">flex: 0 1 auto</a>.
+	This differs from their defaults when omitted in the 'flex' shorthand
+	(effectively ''1 1 0px'')
+	so that the 'flex' shorthand can better accommodate
+	<a href="#flex-common">the most common cases</a>.
+
 	<dl dfn-type=value dfn-for=flex>
 		<dt><dfn><<'flex-grow'>></dfn>
 		<dd>
@@ -1648,12 +1655,6 @@ The 'flex' Shorthand</h3>
 		</figcaption>
 	</figure>
 
-	The initial values of the 'flex' components are equivalent to <a class="css-code" href="#flex-initial">flex: 0 1 auto</a>.
-
-	Note: The initial values of 'flex-grow' and 'flex-basis'
-	are different from their defaults when omitted in the 'flex' shorthand.
-	This is so that the 'flex' shorthand can better accommodate the most <a href="#flex-common">common cases</a>.
-
 	A unitless zero that is not already preceded by two flex factors
 	must be interpreted as a flex factor.
 	To avoid misinterpretation or invalid declarations,
