Rewording the Box Model chapter.

Author: tabatkins

css3-flexbox/Overview.html

@@ -321,8 +321,7 @@ <h2 id=box-model><span class=secno>2. </span> The Flexbox Box Model</h2>
 
   <p>Similar to other layout modes such as table layout, a flexbox acts like
    a block when placed into elements using other layout modes. Inline
-   flexboxes act like inline-blocks. <span class=issue>Figure out the right
-   terms to use here.</span>
+   flexboxes act like inline-blocks.
 
   <div class=example>
    <p>For example, the following HTML snippet declares a flexbox with a few
@@ -377,7 +376,14 @@ <h3 id=display-flexbox><span class=secno>2.1. </span> New values for
    &lsquo;<a href="#flexbox"><code class=property>flexbox</code></a>&rsquo;
    or &lsquo;<code class=property>inline-flexbox</code>&rsquo;.
 
-  <p>Flexbox establishes a new block formatting context for its content.
+  <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.
+
+  <p>A flexbox establishes a new block formatting context for its content.
+
+  <p class=issue>Figure out the right terms to use here.
 
   <h3 id=flex-items><span class=secno>2.2. </span> Flexbox Items</h3>
 
@@ -424,7 +430,7 @@ <h3 id=flex-items><span class=secno>2.2. </span> Flexbox Items</h3>
     &lt;/span>
 
     &lt;!-- flexbox item: block-level replaced element -->
-    &lt;img id="item7">
+    &lt;iframe id="item7">
 
     &lt;!-- flexbox item: inline-level replaced element -->
     &lt;img id="item7" style="display:inline">

css3-flexbox/Overview.src.html

@@ -73,7 +73,7 @@ <h2 id='box-model'>
 
 	<p>In the <i>cross axis</i>, <i>flexbox items</i> can either "flex" to fill the available space or be aligned within the space with the 'flex-align' property.  If a flexbox is <i>multi-line</i>, new lines are added in the <i>cross-end</i> direction, and can similarly be aligned, centered, or distributed within the flexbox with the 'flex-line-pack' property.</p>
 
-	<p>Similar to other layout modes such as table layout, a flexbox acts like a block when placed into elements using other layout modes.  Inline flexboxes act like inline-blocks. <span class=issue>Figure out the right terms to use here.</span></p>
+	<p>Similar to other layout modes such as table layout, a flexbox acts like a block when placed into elements using other layout modes.  Inline flexboxes act like inline-blocks.</p>
 
 	<div class="example">
 		<p>For example, the following HTML snippet declares a flexbox with a few children.  The flexbox is horizontal, and the children's widths don't fill the flexbox's width, so the additional space is distributed between the children.  The flexbox's height isn't explicitly specified, so it shrinks to the height of its tallest child and centers the other children within it:</p>
@@ -108,8 +108,12 @@ <h3 id='display-flexbox'>
 	</table>
 
 	<p>You can declare that an element is a flexbox, and thus should use flexbox layout, 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.</p>
 
-	<p>Flexbox establishes a new block formatting context for its content.</p>
+	<p>A flexbox establishes a new block formatting context for its content.</p>
+
+	<p class='issue'>Figure out the right terms to use here.</p>
 
 
 
@@ -155,7 +159,7 @@ <h3 id='flex-items'>
     &lt;/span>
 
     &lt;!-- flexbox item: block-level replaced element -->
-    &lt;img id="item7">
+    &lt;iframe id="item7"></iframe>
 
     &lt;!-- flexbox item: inline-level replaced element -->
     &lt;img id="item7" style="display:inline">