[css-flexbox] Spam the note warning against using flex-* components to all the sections.

Author: tabatkins

css-flexbox/Overview.bs

@@ -1573,11 +1573,10 @@ Components of Flexibility</h3>
 	<p>
 		Individual components of flexibility can be controlled by independent longhand properties.
 
-	<p class='note'>
-		Authors are encouraged to control flexibility using the 'flex' shorthand
-		rather than with component properties,
-		as the shorthand correctly resets any unspecified components
-		to accommodate <a href="#flex-common">common uses</a>.
+	Note: Authors are encouraged to control flexibility using the 'flex' shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href="#flex-common">common uses</a>.
 
 <h4 id='flex-grow-property'>
 The 'flex-grow' property</h4>
@@ -1593,6 +1592,11 @@ The 'flex-grow' property</h4>
 	Animatable: yes
 	</pre>
 
+	Note: Authors are encouraged to control flexibility using the 'flex' shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href="#flex-common">common uses</a>.
+
 	<p>
 		The 'flex-grow' property sets the <i>flex grow factor</i>
 		to the provided <dfn value for=flex-grow><<number>></dfn>.
@@ -1612,6 +1616,11 @@ The 'flex-shrink' property</h4>
 	Animatable: yes
 	</pre>
 
+	Note: Authors are encouraged to control flexibility using the 'flex' shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href="#flex-common">common uses</a>.
+
 	<p>
 		The 'flex-shrink' property sets the <i>flex shrink factor</i>
 		to the provided <dfn value for=flex-shrink><<number>></dfn>.
@@ -1632,6 +1641,11 @@ The 'flex-basis' property</h4>
 	Animatable: as 'width'
 	</pre>
 
+	Note: Authors are encouraged to control flexibility using the 'flex' shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href="#flex-common">common uses</a>.
+
 	<p>
 		The 'flex-basis' property sets the <i>flex basis</i>.
 		It accepts the same values as the 'width' and 'height' property.
@@ -1640,6 +1654,9 @@ The 'flex-basis' property</h4>
 		The <dfn value for=flex-basis>main-size</dfn> keyword, when specified on a <i>flex item</i>,
 		retrieves the value of the <i>main size property</i>.
 
+	Issue: This value was originally named "auto",
+	but that was confusing
+
 	<p>
 		The <i>flex basis</i> is resolved the same way as 'width' in horizontal writing modes [[!CSS21]]:
 		percentage values of 'flex-basis' are resolved against

css-flexbox/Overview.html

@@ -1614,17 +1614,21 @@ <h3 class="heading settled heading" data-level=7.3 id=flex-components><span clas
 	<p>
 		Individual components of flexibility can be controlled by independent longhand properties.
 
-	<p class=note>
-		Authors are encouraged to control flexibility using the <a class=property data-link-type=propdesc href=#propdef-flex title=flex>flex</a> shorthand
-		rather than with component properties,
-		as the shorthand correctly resets any unspecified components
-		to accommodate <a href=#flex-common>common uses</a>.
+<p class=note>Note: Authors are encouraged to control flexibility using the <a class=property data-link-type=propdesc href=#propdef-flex title=flex>flex</a> shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href=#flex-common>common uses</a>.</p>
 
 <h4 class="heading settled heading" data-level=7.3.1 id=flex-grow-property><span class=secno>7.3.1 </span><span class=content>
 The <a class=property data-link-type=propdesc href=#propdef-flex-grow title=flex-grow>flex-grow</a> property</span><a class=self-link href=#flex-grow-property></a></h4>
 
 <table class="definition propdef"><tr><th>Name:<td><dfn class=css-code data-dfn-type=property data-export="" id=propdef-flex-grow>flex-grow<a class=self-link href=#propdef-flex-grow></a></dfn><tr><th>Value:<td class=prod><a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#number-value title="<number>">&lt;number&gt;</a><tr><th>Initial:<td>0<tr><th>Applies to:<td><a data-link-type=dfn href=#flex-item title="flex items">flex items</a><tr><th>Inherited:<td>no<tr><th>Media:<td>visual<tr><th>Computed value:<td>specified value<tr><th>Animatable:<td>yes</table>
 
+<p class=note>Note: Authors are encouraged to control flexibility using the <a class=property data-link-type=propdesc href=#propdef-flex title=flex>flex</a> shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href=#flex-common>common uses</a>.</p>
+
 	<p>
 		The <a class=property data-link-type=propdesc href=#propdef-flex-grow title=flex-grow>flex-grow</a> property sets the <a data-link-type=dfn href=#flex-grow-factor title="flex grow factor">flex grow factor</a>
 		to the provided <dfn class=css-code data-dfn-for=flex-grow data-dfn-type=value data-export="" id=valuedef-number0><a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#number-value title="<number>">&lt;number&gt;</a><a class=self-link href=#valuedef-number0></a></dfn>.
@@ -1635,6 +1639,11 @@ <h4 class="heading settled heading" data-level=7.3.2 id=flex-shrink-property><sp
 
 <table class="definition propdef"><tr><th>Name:<td><dfn class=css-code data-dfn-type=property data-export="" id=propdef-flex-shrink>flex-shrink<a class=self-link href=#propdef-flex-shrink></a></dfn><tr><th>Value:<td class=prod><a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#number-value title="<number>">&lt;number&gt;</a><tr><th>Initial:<td>1<tr><th>Applies to:<td><a data-link-type=dfn href=#flex-item title="flex items">flex items</a><tr><th>Inherited:<td>no<tr><th>Media:<td>visual<tr><th>Computed value:<td>specified value<tr><th>Animatable:<td>yes</table>
 
+<p class=note>Note: Authors are encouraged to control flexibility using the <a class=property data-link-type=propdesc href=#propdef-flex title=flex>flex</a> shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href=#flex-common>common uses</a>.</p>
+
 	<p>
 		The <a class=property data-link-type=propdesc href=#propdef-flex-shrink title=flex-shrink>flex-shrink</a> property sets the <a data-link-type=dfn href=#flex-shrink-factor title="flex shrink factor">flex shrink factor</a>
 		to the provided <dfn class=css-code data-dfn-for=flex-shrink data-dfn-type=value data-export="" id=valuedef-number><a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#number-value title="<number>">&lt;number&gt;</a><a class=self-link href=#valuedef-number></a></dfn>.
@@ -1645,6 +1654,11 @@ <h4 class="heading settled heading" data-level=7.3.3 id=flex-basis-property><spa
 
 <table class="definition propdef"><tr><th>Name:<td><dfn class=css-code data-dfn-type=property data-export="" id=propdef-flex-basis>flex-basis<a class=self-link href=#propdef-flex-basis></a></dfn><tr><th>Value:<td class=prod>main-size <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> <a class=production data-link-type=propdesc href=http://dev.w3.org/csswg/css2/visudet.html#propdef-width title=width>&lt;‘width’&gt;</a><tr><th>Initial:<td>main-size<tr><th>Applies to:<td><a data-link-type=dfn href=#flex-item title="flex items">flex items</a><tr><th>Inherited:<td>no<tr><th>Media:<td>visual<tr><th>Computed value:<td>as specified, with lengths made absolute<tr><th>Percentages:<td>relative to the <a data-link-type=dfn href=#flex-container title="flex container’s">flex container’s</a> inner <a data-link-type=dfn href=#main-size title="main size">main size</a><tr><th>Animatable:<td>as <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css2/visudet.html#propdef-width title=width>width</a></table>
 
+<p class=note>Note: Authors are encouraged to control flexibility using the <a class=property data-link-type=propdesc href=#propdef-flex title=flex>flex</a> shorthand
+	rather than with component properties,
+	as the shorthand correctly resets any unspecified components
+	to accommodate <a href=#flex-common>common uses</a>.</p>
+
 	<p>
 		The <a class=property data-link-type=propdesc href=#propdef-flex-basis title=flex-basis>flex-basis</a> property sets the <a data-link-type=dfn href=#flex-basis title="flex basis">flex basis</a>.
 		It accepts the same values as the <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css2/visudet.html#propdef-width title=width>width</a> and <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css2/visudet.html#propdef-height title=height>height</a> property.
@@ -1653,6 +1667,9 @@ <h4 class="heading settled heading" data-level=7.3.3 id=flex-basis-property><spa
 		The <dfn class=css-code data-dfn-for=flex-basis data-dfn-type=value data-export="" id=valuedef-main-size>main-size<a class=self-link href=#valuedef-main-size></a></dfn> keyword, when specified on a <a data-link-type=dfn href=#flex-item title="flex item">flex item</a>,
 		retrieves the value of the <a data-link-type=dfn href=#main-size-property title="main size property">main size property</a>.
 
+<p class=issue id=issue-cdba524f><a class=self-link href=#issue-cdba524f></a>This value was originally named "auto",
+	but that was confusing</p>
+
 	<p>
 		The <a data-link-type=dfn href=#flex-basis title="flex basis">flex basis</a> is resolved the same way as <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css2/visudet.html#propdef-width title=width>width</a> in horizontal writing modes <a data-biblio-type=normative data-link-type=biblio href=#biblio-css21 title=biblio-css21>[CSS21]</a>:
 		percentage values of <a class=property data-link-type=propdesc href=#propdef-flex-basis title=flex-basis>flex-basis</a> are resolved against
@@ -3781,7 +3798,10 @@ <h2 class="no-num heading settled" id=issues-index><span class=content>Issues In
 	because 2.1 is incoherent about what "static position" really is.<a href=#issue-bb26f057> ↵ </a></div>
 
 <div class=issue>Audit this for correctness.<a href=#issue-3e8af8e3> ↵ </a></div>
-			<div class=issue>These two algorithms should give the same result.
+			<div class=issue>This value was originally named "auto",
+	but that was confusing<a href=#issue-cdba524f> ↵ </a></div>
+
+	<div class=issue>These two algorithms should give the same result.
 	Please let us know which is more understandable,
 	and also if you notice any discrepencies.<a href=#issue-1b47c007> ↵ </a></div>