Replace issue with note, thanks to roc's feedback. (Similar situations occur with 'opacity', so we're to copy that.)

Author: fantasai

css3-flexbox/Overview.html

@@ -279,14 +279,14 @@ <h2 class="no-num no-toc" id=table>Table of contents</h2>
 
    <li><a href="#flex-items"><span class=secno>4. </span> Flex Items</a>
     <ul class=toc>
-     <li><a href="#flex-item-margins"><span class=secno>4.1. </span> Flex
-      Item Margins</a>
+     <li><a href="#item-margins"><span class=secno>4.1. </span> Flex Item
+      Margins</a>
 
-     <li><a href="#flex-item-painting"><span class=secno>4.2. </span> Flex
-      Item Painting</a>
+     <li><a href="#painting"><span class=secno>4.2. </span> Flex Item
+      Painting</a>
 
-     <li><a href="#abspos-flex-items"><span class=secno>4.3. </span>
-      Out-of-flow Items</a>
+     <li><a href="#abspos-items"><span class=secno>4.3. </span> Out-of-flow
+      Items</a>
 
      <li><a href="#visibility-collapse"><span class=secno>4.4. </span>
       Collapsed Items</a>
@@ -898,15 +898,15 @@ <h2 id=flex-items><span class=secno>4. </span> Flex Items</h2>
    ruby) or otherwise mangle the box tree (e.g. run-ins). It is intended that
    flex item determination run after these operations.
 
-  <h3 id=flex-item-margins><span class=secno>4.1. </span> Flex Item Margins</h3>
+  <h3 id=item-margins><span class=secno>4.1. </span> Flex Item Margins</h3>
 
   <p> The margins of adjacent <a href="#flex-item"><i>flex items</i></a> do
    not collapse. Auto margins absorb extra space in the corresponding
    dimension and can be used for alignment and to push adjacent flex items
    apart; see <a href="#auto-margins">Aligning with ‘<code
    class=css>auto</code>’ margins</a>.
 
-  <h3 id=flex-item-painting><span class=secno>4.2. </span> Flex Item Painting</h3>
+  <h3 id=painting><span class=secno>4.2. </span> Flex Item Painting</h3>
 
   <p> <a href="#flex-item"><i>Flex items</i></a> paint exactly the same as
    block-level elements in the normal flow, except that ‘<code
@@ -915,18 +915,10 @@ <h3 id=flex-item-painting><span class=secno>4.2. </span> Flex Item Painting</h3>
    stacking context even if ‘<code class=property>position</code>’ is
    ‘<code class=css>static</code>’.
 
-  <div class=issue>
-   <p> Descendants of a flex item that establishes a stacking context
-    participate in the stacking context of:
+  <p class=note> Note: Descendants that are positioned outside a flex item
+   still participate in any stacking context established by the flex item.
 
-   <ul style="list-style:upper-alpha">
-    <li>the flex item
-
-    <li>their containing block
-   </ul>
-  </div>
-
-  <h3 id=abspos-flex-items><span class=secno>4.3. </span> Out-of-flow Items</h3>
+  <h3 id=abspos-items><span class=secno>4.3. </span> Out-of-flow Items</h3>
 
   <p> Absolutely positioned children of a flex container are not themselves
    <a href="#flex-item"><i>flex items</i></a>, but they leave behind

css3-flexbox/Overview.src.html

@@ -589,7 +589,7 @@ <h2 id='flex-items'>
 		Future display types may generate anonymous containers (e.g. ruby) or otherwise mangle the box tree (e.g. run-ins).
 		It is intended that flex item determination run after these operations.
 
-<h3 id='flex-item-margins'>
+<h3 id='item-margins'>
 Flex Item Margins</h3>
 
 	<p>
@@ -599,26 +599,18 @@ <h3 id='flex-item-margins'>
 		see <a href="#auto-margins">Aligning with ''auto'' margins</a>.
 
 
-<h3 id='flex-item-painting'>
+<h3 id='painting'>
 Flex Item Painting</h3>
 
 	<p>
 		<i>Flex items</i> paint exactly the same as block-level elements in the normal flow,
 		except that 'z-index' values other than ''auto'' create a stacking context
 		even if 'position' is ''static''.
+	<p class="note">
+		Note: Descendants that are positioned outside a flex item still participate
+		in any stacking context established by the flex item.
 
-	<div class='issue'>
-		<p>
-			Descendants of a flex item that establishes a stacking context participate in the stacking context of:
-		
-		<ul style="list-style:upper-alpha">
-			<li>the flex item
-			<li>their containing block
-		</ul>
-	</div>
-
-
-<h3 id='abspos-flex-items'>
+<h3 id='abspos-items'>
 Out-of-flow Items</h3>
 
 	<p>