Cleanup of the display:flexbox section, get appropriate wording so I can remove the issue.

Author: tabatkins

css3-flexbox/Overview.html

@@ -458,14 +458,13 @@ <h3 id=display-flexbox><span class=secno>2.1. </span> New values for
    or &lsquo;<code class=property>inline-flexbox</code>&rsquo;.
 
   <p>The &lsquo;<a href="#flexbox"><code class=css>flexbox</code></a>&rsquo;
-   value makes the flexbox act like a block in other layout modes. The
-   &lsquo;<code class=css>inline-flexbox</code>&rsquo; value makes the
-   flexbox act like an inline-block in other layout modes. When it is
-   necessary to distinguish them, this specification will refer to the former
-   kind of flexbox as <dfn id=block-flexbox
-   title="block flexbox|block flexboxes">block flexboxes</dfn> and the latter
-   type as <dfn id=inline-flexbox
-   title="inline flexbox|inline flexboxes">inline flexboxes</dfn>.
+   value makes the flexbox a block-level element. The &lsquo;<code
+   class=css>inline-flexbox</code>&rsquo; value makes the flexbox an
+   inline-level element. When it is necessary to distinguish them, this
+   specification will refer to the former kind of flexbox as a <dfn
+   id=block-flexbox title="block flexbox|block flexboxes">block flexbox</dfn>
+   and the latter type as an <dfn id=inline-flexbox
+   title="inline flexbox|inline flexboxes">inline flexbox</dfn>.
 
   <p>Flexboxes use a new layout algorithm, and so some properties that were
    designed with the assumption of block layout don't make sense in a flexbox
@@ -486,7 +485,7 @@ <h3 id=display-flexbox><span class=secno>2.1. </span> New values for
     &lsquo;<code class=property>display</code>&rsquo;).
 
    <li>&lsquo;<code class=property>vertical-align</code>&rsquo; has no effect
-    on a flexbox item
+    on the alignment of a flexbox item in the flexbox
   </ul>
 
   <p>If an element's specified value for &lsquo;<code
@@ -496,14 +495,12 @@ <h3 id=display-flexbox><span class=secno>2.1. </span> New values for
    class=property>display</code>&rsquo; must be &lsquo;<a
    href="#flexbox"><code class=css>flexbox</code></a>&rsquo;.
 
-  <p>A flexbox creates a new flexbox formatting context for its contents.
-   This is similar to a block formatting context: floats must not intrude
-   into the flexbox, and the flexbox's margins do not collapse with the
-   margins of its contents. Additionally, all of the <a
-   href="#flexbox-item"><i>flexbox items</i></a> establish new block
-   formatting contexts for their contents.
-
-  <p class=issue>Figure out the right terms to use here.
+  <p>A flexbox establishes a new <dfn id=flexbox-formatting-context>flexbox
+   formatting context</dfn> for its contents. This is similar to a block
+   formatting context root: floats do not intrude into the flexbox, and the
+   flexbox's margins do not collapse with the margins of its contents.
+   Additionally, each of the <a href="#flexbox-item"><i>flexbox items</i></a>
+   establish a new formatting context for its contents.
 
   <h3 id=flex-items><span class=secno>2.2. </span> Flexbox Items</h3>
 
@@ -2551,6 +2548,9 @@ <h2 class=no-num id=index>Index</h2>
 
    <li>flexbox, <a href="#flexbox" title=flexbox><strong>2.</strong></a>
 
+   <li>flexbox formatting context, <a href="#flexbox-formatting-context"
+    title="flexbox formatting context"><strong>2.1.</strong></a>
+
    <li>flexbox item, <a href="#flexbox-item"
     title="flexbox item"><strong>2.</strong></a>
 

css3-flexbox/Overview.src.html

@@ -156,7 +156,7 @@ <h3 id='display-flexbox'>
 
 	<p>You can declare that an element is a flexbox, and thus should use flexbox layout for its contents, by setting the 'display' property on the element to the value 'flexbox' or 'inline-flexbox'.</p>
 
-	<p>The ''flexbox'' value makes the flexbox act like a block in other layout modes.  The ''inline-flexbox'' value makes the flexbox act like an inline-block in other layout modes.  When it is necessary to distinguish them, this specification will refer to the former kind of flexbox as <dfn id="block-flexbox" title="block flexbox|block flexboxes">block flexboxes</dfn> and the latter type as <dfn id="inline-flexbox" title="inline flexbox|inline flexboxes">inline flexboxes</dfn>.</p>
+	<p>The ''flexbox'' value makes the flexbox a block-level element.  The ''inline-flexbox'' value makes the flexbox an inline-level element.  When it is necessary to distinguish them, this specification will refer to the former kind of flexbox as a <dfn id="block-flexbox" title="block flexbox|block flexboxes">block flexbox</dfn> and the latter type as an <dfn id="inline-flexbox" title="inline flexbox|inline flexboxes">inline flexbox</dfn>.</p>
 
 	<p>Flexboxes use a new layout algorithm, and so some properties that were designed with the assumption of block layout don't make sense in a flexbox context.  In particular:</p>
 
@@ -165,15 +165,12 @@ <h3 id='display-flexbox'>
 
 		<li>'float' and 'clear' have no effect on a flexbox item.  Using 'float' on an element still causes that element's 'display' property to compute to ''block'', as normal, because that occurs before flexbox items are determined (the algorithm for wrapping children of a flexbox into <i>flexbox items</i> needs the computed value of 'display').</li>
 
-		<li>'vertical-align' has no effect on a flexbox item</li>
+		<li>'vertical-align' has no effect on the alignment of a flexbox item in the flexbox</li>
 	</ul>
 
 	<p>If an element's specified value for 'display' is ''inline-flexbox'' and the element is floated or absolutely positioned, the computed value of 'display' must be ''flexbox''.</p>
 
-	<p>A flexbox creates a new flexbox formatting context for its contents.  This is similar to a block formatting context: floats must not intrude into the flexbox, and the flexbox's margins do not collapse with the margins of its contents.  Additionally, all of the <i>flexbox items</i> establish new block formatting contexts for their contents.</p>
-
-	<p class='issue'>Figure out the right terms to use here.</p>
-
+	<p>A flexbox establishes a new <dfn>flexbox formatting context</dfn> for its contents.  This is similar to a block formatting context root: floats do not intrude into the flexbox, and the flexbox's margins do not collapse with the margins of its contents.  Additionally, each of the <i>flexbox items</i> establish a new formatting context for its contents.</p>
 
 
 <h3 id='flex-items'>