csswg/css3-flexbox Overview.html,1.40,1.41 Overview.src.html,1.39,1.40

Update of /sources/public/csswg/css3-flexbox
In directory hutz:/tmp/cvs-serv12927

Modified Files:
	Overview.html Overview.src.html 
Log Message:
More rewriting of the flow/order section.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-flexbox/Overview.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -d -r1.40 -r1.41
--- Overview.html	23 Aug 2011 01:14:07 -0000	1.40
+++ Overview.html	23 Aug 2011 17:46:39 -0000	1.41
@@ -142,69 +142,73 @@
       Items</a>
     </ul>
 
-   <li><a href="#flex-flow"><span class=secno>3. </span> Flexbox Flow
-    Direction: the &lsquo;<code class=property>flex-flow</code>&rsquo;
-    property</a>
+   <li><a href="#ordering-orientation"><span class=secno>3. </span> Ordering
+    and Orientation</a>
+    <ul class=toc>
+     <li><a href="#flex-flow"><span class=secno>3.1. </span> Flexbox Flow
+      Direction: the &lsquo;<code class=property>flex-flow</code>&rsquo;
+      property</a>
 
-   <li><a href="#flex-order"><span class=secno>4. </span> Display Order: the
-    &lsquo;<code class=property>flex-order</code>&rsquo; property</a>
+     <li><a href="#flex-order"><span class=secno>3.2. </span> Display Order:
+      the &lsquo;<code class=property>flex-order</code>&rsquo; property</a>
+    </ul>
 
-   <li><a href="#flexibility"><span class=secno>5. </span> Flexibility</a>
+   <li><a href="#flexibility"><span class=secno>4. </span> Flexibility</a>
     <ul class=toc>
-     <li><a href="#resolving-flexible-lengths"><span class=secno>5.1. </span>
+     <li><a href="#resolving-flexible-lengths"><span class=secno>4.1. </span>
       Resolving Flexible Lengths</a>
 
-     <li><a href="#flex-function"><span class=secno>5.2. </span> The
+     <li><a href="#flex-function"><span class=secno>4.2. </span> The
       &lsquo;<code class=css>flex()</code>&rsquo; function</a>
 
-     <li><a href="#flexible-margins"><span class=secno>5.3. </span> Flexible
+     <li><a href="#flexible-margins"><span class=secno>4.3. </span> Flexible
       margins and paddings</a>
     </ul>
 
-   <li><a href="#flex-pack"><span class=secno>6. </span> The &lsquo;<code
+   <li><a href="#flex-pack"><span class=secno>5. </span> The &lsquo;<code
     class=property>flex-pack</code>&rsquo; property</a>
 
-   <li><a href="#flex-align"><span class=secno>7. </span> The &lsquo;<code
+   <li><a href="#flex-align"><span class=secno>6. </span> The &lsquo;<code
     class=property>flex-align</code>&rsquo; property</a>
 
-   <li><a href="#multiline"><span class=secno>8. </span> Multi-line
+   <li><a href="#multiline"><span class=secno>7. </span> Multi-line
     flexbox</a>
     <ul class=toc>
-     <li><a href="#flex-line-pack"><span class=secno>8.1. </span>
+     <li><a href="#flex-line-pack"><span class=secno>7.1. </span>
       &lsquo;<code class=property>flex-line-pack</code>&rsquo; property</a>
     </ul>
 
-   <li><a href="#free-space-algorithm"><span class=secno>9. </span> Free
+   <li><a href="#free-space-algorithm"><span class=secno>8. </span> Free
     Space Calculation and Distribution</a>
     <ul class=toc>
-     <li><a href="#free-space-algorithm-initial"><span class=secno>9.1.
+     <li><a href="#free-space-algorithm-initial"><span class=secno>8.1.
       </span> Initial Computation</a>
 
-     <li><a href="#first-distribution-round"><span class=secno>9.2. </span>
+     <li><a href="#first-distribution-round"><span class=secno>8.2. </span>
       First Distribution Round</a>
 
-     <li><a href="#second-distribution-round"><span class=secno>9.3. </span>
+     <li><a href="#second-distribution-round"><span class=secno>8.3. </span>
       Second Distribution Round</a>
 
-     <li><a href="#intermediate-computation"><span class=secno>9.4. </span>
+     <li><a href="#intermediate-computation"><span class=secno>8.4. </span>
       Intermediate Computation</a>
 
-     <li><a href="#third-distribution-round"><span class=secno>9.5. </span>
+     <li><a href="#third-distribution-round"><span class=secno>8.5. </span>
       Third Distribution Round</a>
 
-     <li><a href="#free-space-allocation-algorithm"><span class=secno>9.6.
+     <li><a href="#free-space-allocation-algorithm"><span class=secno>8.6.
       </span> Free Space Allocation Algorithm</a>
     </ul>
 
-   <li><a href="#pagination"><span class=secno>10. </span> Page breaks in
+   <li><a href="#pagination"><span class=secno>9. </span> Page breaks in
     flexbox</a>
 
-   <li><a href="#layout-interface"><span class=secno>11. </span> Interface
+   <li><a href="#layout-interface"><span class=secno>10. </span> Interface
     With Other Layout Algorithms</a>
 
-   <li><a href="#changes"><span class=secno>12. </span>Changes</a>
+   <li><a href="#changes"><span class=secno>11. </span>Changes</a>
     <ul class=toc>
-     <li><a href="#changes-from-ed-16-june-2011"><span class=secno>12.1.
+     <li><a href="#changes-from-ed-16-june-2011"><span class=secno>11.1.
       </span>Changes from ED 16-June-2011</a>
     </ul>
 
@@ -485,9 +489,25 @@
    &lsquo;<code class=property>height</code>&rsquo; properties are
    &lsquo;<code class=css>auto</code>&rsquo;), similar to tables or floats.
 
-  <h2 id=flex-flow><span class=secno>3. </span> Flexbox Flow Direction: the
+  <h2 id=ordering-orientation><span class=secno>3. </span> Ordering and
+   Orientation</h2>
+
+  <p>The first level of flexbox functionality is the ability to lay out a
+   flexbox's contents in any direction and in any order. This allows an
+   author to trivially achieve effects that would previously have required
+   complex or fragile methods, such as using the &lsquo;<code
+   class=property>float</code>&rsquo; property to lay out a horizontal
+   navigation bar (which then requires further effort with the &lsquo;<code
+   class=property>clear</code>&rsquo; property or others to make the elements
+   interact nicely with the rest of the page). This functionality is exposed
+   through the &lsquo;<a href="#flex-flow0"><code
+   class=property>flex-flow</code></a>&rsquo; and &lsquo;<a
+   href="#flex-order0"><code class=property>flex-order</code></a>&rsquo;
+   properties.
+
+  <h3 id=flex-flow><span class=secno>3.1. </span> Flexbox Flow Direction: the
    &lsquo;<a href="#flex-flow0"><code
-   class=property>flex-flow</code></a>&rsquo; property</h2>
+   class=property>flex-flow</code></a>&rsquo; property</h3>
 
   <table class=propdef>
    <tbody>
@@ -741,11 +761,11 @@
       flex-flow:vertical wrap-reverse }    /* cross axis is left-to-right (opposite to block direction) */</pre>
   </div>
 
-  <h2 id=flex-order><span class=secno>4. </span> Display Order: the &lsquo;<a
-   href="#flex-order0"><code class=property>flex-order</code></a>&rsquo;
-   property</h2>
+  <h3 id=flex-order><span class=secno>3.2. </span> Display Order: the
+   &lsquo;<a href="#flex-order0"><code
+   class=property>flex-order</code></a>&rsquo; property</h3>
 
-  <p><a href="#flexbox-item"><i>flexbox items</i></a> are, by default,
+  <p><a href="#flexbox-item"><i>Flexbox items</i></a> are, by default,
    displayed and laid out in the same order as they appear in the source
    document. The &lsquo;<a href="#flex-order0"><code
    class=property>flex-order</code></a>&rsquo; property may be used to change
@@ -823,7 +843,11 @@
    <pre><code>item2 item4 item1 item3</code></pre>
   </div>
 
-  <h2 id=flexibility><span class=secno>5. </span> Flexibility</h2>
+  <p class=issue>Add a realistic example of tab reordering.
+
+  <p class=issue>Add an example of reordering columns in a page.
+
+  <h2 id=flexibility><span class=secno>4. </span> Flexibility</h2>
 
   <p>The defining aspect of flexbox layout is the ability to make various
    lengths of the <a href="#flexbox-item"><i>flexbox items</i></a> flexible.
@@ -841,7 +865,7 @@
    <p class=issue>TODO: Examples!</p>
   </div>
 
-  <h3 id=resolving-flexible-lengths><span class=secno>5.1. </span> Resolving
+  <h3 id=resolving-flexible-lengths><span class=secno>4.1. </span> Resolving
    Flexible Lengths</h3>
 
   <p>Flexbox layout resolves a <i>flexible length</i> into a definite length
@@ -881,7 +905,7 @@
    precise details of how free space is determined and assigned to flexible
    lengths is detailed in a later chapter.
 
-  <h3 id=flex-function><span class=secno>5.2. </span> The &lsquo;<code
+  <h3 id=flex-function><span class=secno>4.2. </span> The &lsquo;<code
    class=css>flex()</code>&rsquo; function</h3>
 
   <p>The &lsquo;<code class=css>flex()</code>&rsquo; function is used to
@@ -998,7 +1022,7 @@
    <i>preferred size</i> in pixels when in "quirks mode" and when it is the
    third value in flex() function with three values.
 
-  <h3 id=flexible-margins><span class=secno>5.3. </span> Flexible margins and
+  <h3 id=flexible-margins><span class=secno>4.3. </span> Flexible margins and
    paddings</h3>
 
   <p>Paddings and margins are made flexible by setting their value to
@@ -1025,7 +1049,7 @@
   <p class=issue>TODO: need solid use cases (and illustrations here) for
    flexible margins and paddings.
 
-  <h2 id=flex-pack><span class=secno>6. </span> The &lsquo;<a
+  <h2 id=flex-pack><span class=secno>5. </span> The &lsquo;<a
    href="#flex-pack0"><code class=property>flex-pack</code></a>&rsquo;
    property</h2>
 
@@ -1117,7 +1141,7 @@
    <p class=issue>TODO: Examples showing the four values.</p>
   </div>
 
-  <h2 id=flex-align><span class=secno>7. </span> The &lsquo;<a
+  <h2 id=flex-align><span class=secno>6. </span> The &lsquo;<a
    href="#flex-align0"><code class=property>flex-align</code></a>&rsquo;
    property</h2>
 
@@ -1375,7 +1399,7 @@
   <p class=issue>TODO: alignment rules should be compatible with
    css3-grid-layout, if possible
 
-  <h2 id=multiline><span class=secno>8. </span> Multi-line flexbox</h2>
+  <h2 id=multiline><span class=secno>7. </span> Multi-line flexbox</h2>
 
   <p>If no &lsquo;<code class=property>wrap-</code>&rsquo; keyword is
    included in &lsquo;<a href="#flex-flow0"><code
@@ -1490,7 +1514,7 @@
    </div>
   </div>
 
-  <h3 id=flex-line-pack><span class=secno>8.1. </span> &lsquo;<a
+  <h3 id=flex-line-pack><span class=secno>7.1. </span> &lsquo;<a
    href="#propdef-flex-line-pack"><code
    class=property>flex-line-pack</code></a>&rsquo; property</h3>
 
@@ -1573,7 +1597,7 @@
 
   <p class=issue>TODO: examples
 
-  <h2 id=free-space-algorithm><span class=secno>9. </span> Free Space
+  <h2 id=free-space-algorithm><span class=secno>8. </span> Free Space
    Calculation and Distribution</h2>
 
   <p class=issue>IS THIS SECTION NECESSARY? It may be useful for implementors
@@ -1633,7 +1657,7 @@
     "inner length" == "extent along cross axis"</p>
   </div>
 
-  <h3 id=free-space-algorithm-initial><span class=secno>9.1. </span> Initial
+  <h3 id=free-space-algorithm-initial><span class=secno>8.1. </span> Initial
    Computation</h3>
 
   <p>This step computes necessary information required to run the free-space
@@ -1761,7 +1785,7 @@
     </dl>
   </ol>
 
-  <h3 id=first-distribution-round><span class=secno>9.2. </span> First
+  <h3 id=first-distribution-round><span class=secno>8.2. </span> First
    Distribution Round</h3>
 
   <p>This step distributes free space to the flexible lengths of the flexbox
@@ -1798,7 +1822,7 @@
    href="#available-free-space"><i>available free space</i></a> equal to the
    flexbox's inner measure.
 
-  <h3 id=second-distribution-round><span class=secno>9.3. </span> Second
+  <h3 id=second-distribution-round><span class=secno>8.3. </span> Second
    Distribution Round</h3>
 
   <p>This step distributes any leftover available space to the <a
@@ -1814,13 +1838,13 @@
    href="#available-free-space"><i>available free space</i></a> equal to the
    flexbox's inner measure.
 
-  <h3 id=intermediate-computation><span class=secno>9.4. </span> Intermediate
+  <h3 id=intermediate-computation><span class=secno>8.4. </span> Intermediate
    Computation</h3>
 
   <p>Determine the length of the flexbox, given the sizes that have already
    been determined.
 
-  <h3 id=third-distribution-round><span class=secno>9.5. </span> Third
+  <h3 id=third-distribution-round><span class=secno>8.5. </span> Third
    Distribution Round</h3>
 
   <p>This step distributes free space to the flexible lengths of each flexbox
@@ -1868,7 +1892,7 @@
    href="#available-free-space"><i>available free space</i></a> equal to the
    flexbox's inner length.
 
-  <h3 id=free-space-allocation-algorithm><span class=secno>9.6. </span> Free
+  <h3 id=free-space-allocation-algorithm><span class=secno>8.6. </span> Free
    Space Allocation Algorithm</h3>
 
   <p>This section describes the algorithm used to allocate free space to a
@@ -1949,7 +1973,7 @@
     inflexible lengths equal to their preferred size, and return them.
   </ol>
 
-  <h2 id=pagination><span class=secno>10. </span> Page breaks in flexbox</h2>
+  <h2 id=pagination><span class=secno>9. </span> Page breaks in flexbox</h2>
 
   <p class=issue>TODO: define how flexbox should break on pages, columns,
    etc. This may or may not be normative until there is more than one
@@ -1991,7 +2015,7 @@
   <p class=issue>TODO: add more detail: how breaking affect sizing (for
    broken boxes and boxes after the break) and alignment
 
-  <h2 id=layout-interface><span class=secno>11. </span> Interface With Other
+  <h2 id=layout-interface><span class=secno>10. </span> Interface With Other
    Layout Algorithms</h2>
 
   <div class=issue>
@@ -2058,9 +2082,9 @@
 
   <hr title="Separator from footer">
 
-  <h2 id=changes><span class=secno>12. </span>Changes</h2>
+  <h2 id=changes><span class=secno>11. </span>Changes</h2>
 
-  <h3 id=changes-from-ed-16-june-2011><span class=secno>12.1. </span>Changes
+  <h3 id=changes-from-ed-16-june-2011><span class=secno>11.1. </span>Changes
    from ED 16-June-2011</h3>
 
   <ul>
@@ -2321,27 +2345,27 @@
 
   <ul class=indexlist>
    <li>after, <a href="#flex-align-after"
-    title=after><strong>7.</strong></a>, <a href="#flex-line-pack-after"
-    title=after><strong>8.1.</strong></a>
+    title=after><strong>6.</strong></a>, <a href="#flex-line-pack-after"
+    title=after><strong>7.1.</strong></a>
 
    <li>available free space, <a href="#available-free-space" title="available
-    free space"><strong>9.</strong></a>
+    free space"><strong>8.</strong></a>
 
    <li>baseline, <a href="#flex-align-baseline"
-    title=baseline><strong>7.</strong></a>
+    title=baseline><strong>6.</strong></a>
 
    <li>before, <a href="#flex-align-before"
-    title=before><strong>7.</strong></a>, <a href="#flex-line-pack-before"
-    title=before><strong>8.1.</strong></a>
+    title=before><strong>6.</strong></a>, <a href="#flex-line-pack-before"
+    title=before><strong>7.1.</strong></a>
 
    <li>center, <a href="#flex-pack-center"
-    title=center><strong>6.</strong></a>
+    title=center><strong>5.</strong></a>
 
    <li>column, <a href="#flex-flow-column"
-    title=column><strong>3.</strong></a>
+    title=column><strong>3.1.</strong></a>
 
    <li>column-reverse, <a href="#flex-flow-column-reverse"
-    title=column-reverse><strong>3.</strong></a>
+    title=column-reverse><strong>3.1.</strong></a>
 
    <li>cross axis, <a href="#cross-axis" title="cross
     axis"><strong>2.</strong></a>
@@ -2356,12 +2380,12 @@
     title=cross-start><strong>2.</strong></a>
 
    <li>distribute, <a href="#flex-line-pack-distribute"
-    title=distribute><strong>8.1.</strong></a>
+    title=distribute><strong>7.1.</strong></a>
 
-   <li>end, <a href="#flex-pack-end" title=end><strong>6.</strong></a>
+   <li>end, <a href="#flex-pack-end" title=end><strong>5.</strong></a>
 
    <li>flex-align, <a href="#flex-align0"
-    title=flex-align><strong>7.</strong></a>
+    title=flex-align><strong>6.</strong></a>
 
    <li>flexbox, <a href="#flexbox" title=flexbox><strong>2.</strong></a>
 
@@ -2375,43 +2399,43 @@
     item's"><strong>2.</strong></a>
 
    <li>flex-flow, <a href="#flex-flow0"
-    title=flex-flow><strong>3.</strong></a>
+    title=flex-flow><strong>3.1.</strong></a>
 
    <li>flex-line-pack, <a href="#propdef-flex-line-pack"
-    title=flex-line-pack><strong>8.1.</strong></a>
+    title=flex-line-pack><strong>7.1.</strong></a>
 
    <li>flex-order, <a href="#flex-order0"
-    title=flex-order><strong>4.</strong></a>
+    title=flex-order><strong>3.2.</strong></a>
 
    <li>flex-pack, <a href="#flex-pack0"
-    title=flex-pack><strong>6.</strong></a>
+    title=flex-pack><strong>5.</strong></a>
 
    <li>flex tuple, <a href="#flex-tuple" title="flex
-    tuple"><strong>9.</strong></a>
+    tuple"><strong>8.</strong></a>
 
    <li>flex tuples, <a href="#flex-tuples" title="flex
-    tuples"><strong>9.1.</strong></a>
+    tuples"><strong>8.1.</strong></a>
 
    <li>horizontal, <a href="#flex-flow-horizontal"
-    title=horizontal><strong>3.</strong></a>
+    title=horizontal><strong>3.1.</strong></a>
 
    <li>horizontal-ltr, <a href="#flex-flow-horizontal-ltr"
-    title=horizontal-ltr><strong>3.</strong></a>
+    title=horizontal-ltr><strong>3.1.</strong></a>
 
    <li>horizontal-reverse, <a href="#flex-flow-horizontal-reverse"
-    title=horizontal-reverse><strong>3.</strong></a>
+    title=horizontal-reverse><strong>3.1.</strong></a>
 
    <li>horizontal-rtl, <a href="#flex-flow-horizontal-rtl"
-    title=horizontal-rtl><strong>3.</strong></a>
+    title=horizontal-rtl><strong>3.1.</strong></a>
 
    <li>inner length, <a href="#inner-length" title="inner
-    length"><strong>9.</strong></a>
+    length"><strong>8.</strong></a>
 
    <li>inner measure, <a href="#inner-measure" title="inner
-    measure"><strong>9.</strong></a>
+    measure"><strong>8.</strong></a>
 
    <li>justify, <a href="#flex-pack-justify"
-    title=justify><strong>6.</strong></a>
+    title=justify><strong>5.</strong></a>
 
    <li>main axis, <a href="#main-axis" title="main
     axis"><strong>2.</strong></a>
@@ -2425,65 +2449,65 @@
     title=main-start><strong>2.</strong></a>
 
    <li>middle, <a href="#flex-align-middle"
-    title=middle><strong>7.</strong></a>, <a href="#flex-line-pack-middle"
-    title=middle><strong>8.1.</strong></a>
+    title=middle><strong>6.</strong></a>, <a href="#flex-line-pack-middle"
+    title=middle><strong>7.1.</strong></a>
 
    <li>negative flexibility, <a href="#negative-flexibility" title="negative
-    flexibility"><strong>5.1.</strong></a>
+    flexibility"><strong>4.1.</strong></a>
 
    <li>packing space, <a href="#packing-space" title="packing
-    space"><strong>6.</strong></a>
+    space"><strong>5.</strong></a>
 
    <li>positive flexibility, <a href="#positive-flexibility" title="positive
-    flexibility"><strong>5.1.</strong></a>
+    flexibility"><strong>4.1.</strong></a>
 
    <li>pre-flex size, <a href="#pre-flex-size" title="pre-flex
-    size"><strong>5.1.</strong></a>
+    size"><strong>4.1.</strong></a>
 
    <li>relevant length, <a href="#relevant-length" title="relevant
-    length"><strong>9.</strong></a>
+    length"><strong>8.</strong></a>
 
-   <li>row, <a href="#flex-flow-row" title=row><strong>3.</strong></a>
+   <li>row, <a href="#flex-flow-row" title=row><strong>3.1.</strong></a>
 
    <li>row-reverse, <a href="#flex-flow-row-reverse"
-    title=row-reverse><strong>3.</strong></a>
+    title=row-reverse><strong>3.1.</strong></a>
 
-   <li>start, <a href="#flex-pack-start" title=start><strong>6.</strong></a>
+   <li>start, <a href="#flex-pack-start" title=start><strong>5.</strong></a>
 
    <li>stretch, <a href="#flex-align-stretch"
-    title=stretch><strong>7.</strong></a>
+    title=stretch><strong>6.</strong></a>
 
    <li>total free space, <a href="#total-free-space" title="total free
-    space"><strong>9.</strong></a>
+    space"><strong>8.</strong></a>
 
    <li>vertical, <a href="#flex-flow-vertical"
-    title=vertical><strong>3.</strong></a>
+    title=vertical><strong>3.1.</strong></a>
 
    <li>vertical-btt, <a href="#flex-flow-row-vertical-btt"
-    title=vertical-btt><strong>3.</strong></a>
+    title=vertical-btt><strong>3.1.</strong></a>
 
    <li>vertical-reverse, <a href="#flex-flow-vertical-reverse"
-    title=vertical-reverse><strong>3.</strong></a>
+    title=vertical-reverse><strong>3.1.</strong></a>
 
    <li>vertical-ttb, <a href="#flex-flow-vertical-ttb"
-    title=vertical-ttb><strong>3.</strong></a>
+    title=vertical-ttb><strong>3.1.</strong></a>
 
-   <li>wrap, <a href="#flex-flow-wrap" title=wrap><strong>3.</strong></a>
+   <li>wrap, <a href="#flex-flow-wrap" title=wrap><strong>3.1.</strong></a>
 
    <li>wrap-down, <a href="#flex-flow-wrap-down"
-    title=wrap-down><strong>3.</strong></a>
+    title=wrap-down><strong>3.1.</strong></a>
 
    <li>wrap-left, <a href="#flex-flow-wrap-left"
-    title=wrap-left><strong>3.</strong></a>
+    title=wrap-left><strong>3.1.</strong></a>
 
    <li>wrap-reverse, <a href="#flex-flow-wrap-reverse"
-    title=wrap-reverse><strong>3.</strong></a>
+    title=wrap-reverse><strong>3.1.</strong></a>
 
    <li>wrap-right, <a href="#flex-flow-wrap-right"
-    title=wrap-right><strong>3.</strong></a>
+    title=wrap-right><strong>3.1.</strong></a>
 
    <li>wrap-up, <a href="#flex-flow-wrap-up"
-    title=wrap-up><strong>3.</strong></a>
+    title=wrap-up><strong>3.1.</strong></a>
   </ul>
   <!--end-index-->
 </html>

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-flexbox/Overview.src.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- Overview.src.html	23 Aug 2011 01:14:07 -0000	1.39
+++ Overview.src.html	23 Aug 2011 17:46:39 -0000	1.40
@@ -190,9 +190,13 @@
 
 	<p>A flexbox item creates a new BFC.  The margins of a flexbox item do not collapse with any other margin.  Flexboxes "shrinkwrap" their contents by default (when their 'width' or 'height' properties are ''auto''), similar to tables or floats.</p>
 
+<h2 id='ordering-orientation'>
+Ordering and Orientation</h2>
 
-<h2 id='flex-flow'>
-Flexbox Flow Direction: the 'flex-flow' property</h2>
+	<p>The first level of flexbox functionality is the ability to lay out a flexbox's contents in any direction and in any order.  This allows an author to trivially achieve effects that would previously have required complex or fragile methods, such as using the 'float' property to lay out a horizontal navigation bar (which then requires further effort with the 'clear' property or others to make the elements interact nicely with the rest of the page).  This functionality is exposed through the 'flex-flow' and 'flex-order' properties.</p>
+
+<h3 id='flex-flow'>
+Flexbox Flow Direction: the 'flex-flow' property</h3>
 
 	<table class=propdef>
 		<tbody>
@@ -327,10 +331,10 @@
 	</div>
 
 
-<h2 id='flex-order'>
-Display Order: the 'flex-order' property</h2>
+<h3 id='flex-order'>
+Display Order: the 'flex-order' property</h3>
 
-	<p><i>flexbox items</i> are, by default, displayed and laid out in the same order as they appear in the source document.  The 'flex-order' property may be used to change this ordering.</p>
+	<p><i>Flexbox items</i> are, by default, displayed and laid out in the same order as they appear in the source document.  The 'flex-order' property may be used to change this ordering.</p>
 
 	<table class=propdef>
 		<tr>
@@ -379,6 +383,10 @@
 		<pre><code>item2 item4 item1 item3</code></pre>
 	</div>
 
+	<p class='issue'>Add a realistic example of tab reordering.</p>
+
+	<p class='issue'>Add an example of reordering columns in a page.</p>
+
 
 <h2 id='flexibility'>
 Flexibility</h2>

Received on Tuesday, 23 August 2011 17:46:50 UTC