Skip to content

Commit abbf3c3

Browse files
committed
Minor editorial fixes to overview.
1 parent 032ab28 commit abbf3c3

2 files changed

Lines changed: 31 additions & 29 deletions

File tree

css3-flexbox/Overview.html

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -576,10 +576,10 @@ <h3 id=overview><span class=secno>1.1. </span> Overview</h3>
576576
<li> can be laid out in any <a href="#flex-direction-property">flow
577577
direction</a> (leftwards, rightwards, downwards, or even upwards!)
578578

579-
<li> can have their visual order <a
579+
<li> can have their display order <a
580580
href="#flex-flow-row-reverse">reversed</a> or <a
581-
href="#order-property">rearranged</a> at the style layer (i.e., display
582-
order can be independent of source order)
581+
href="#order-property">rearranged</a> at the style layer (i.e., visual
582+
order can be independent of source and speech order)
583583

584584
<li> can be laid out linearly along a single (<a href="#main-axis"><i
585585
title="main axis">main</i></a>) axis or <a
@@ -602,26 +602,28 @@ <h3 id=overview><span class=secno>1.1. </span> Overview</h3>
602602
<p> Here's an example of a catalog where each item has a title, an photo,
603603
a description, and a purchase button. The designer's intention is that
604604
each entry has the same overall size, that the photo be above the text,
605-
and the purchase buttons aligned at the bottom, regardless of the length
606-
of the item's description. Flex layout makes many aspects of this design
607-
easy:
605+
and that the purchase buttons aligned at the bottom, regardless of the
606+
length of the item's description. Flex layout makes many aspects of this
607+
design easy:
608608

609609
<ul>
610-
<li> The catalog uses flex layout to lay out a row of items horizontally,
611-
and to ensure they're all equal-height. Each entry is then itself a
612-
column flex container, laying out its contents vertically.
613-
614-
<li> Within each entry, content is ordered logically with the title
615-
first, followed by the description and the photo. This provides a
616-
sensible ordering for speech rendering and in non-CSS browsers. For a
617-
more compelling visual presentation, however, ‘<a href="#order"><code
618-
class=property>order</code></a>’ is used to pull the image up from
619-
later in the content to the top, and ‘<a href="#align-self"><code
620-
class=property>align-self</code></a>’ to center it horizontally.
610+
<li> The catalog uses flex layout to lay out rows of items horizontally,
611+
and to ensure that items within a row are all equal-height. Each entry
612+
is then itself a column flex container, laying out its contents
613+
vertically.
614+
615+
<li> Within each entry, the source document content is ordered logically
616+
with the title first, followed by the description and the photo. This
617+
provides a sensible ordering for speech rendering and in non-CSS
618+
browsers. For a more compelling visual presentation, however, ‘<a
619+
href="#order"><code class=property>order</code></a>’ is used to pull
620+
the image up from later in the content to the top, and ‘<a
621+
href="#align-self"><code class=property>align-self</code></a>’ is used
622+
to center it horizontally.
621623

622624
<li> An <a href="#auto-margins"><code class=css>auto</code>
623-
margin</a> above the purchase button forces it to the bottom of the
624-
entry box, regardless of the height of the description.
625+
margin</a> above the purchase button forces it to the bottom within each
626+
entry box, regardless of the height of that item's description.
625627
</ul>
626628

627629
<pre>

css3-flexbox/Overview.src.html

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -305,9 +305,9 @@ <h3 id="overview">
305305
can be laid out in any <a href="#flex-direction-property">flow direction</a>
306306
(leftwards, rightwards, downwards, or even upwards!)
307307
<li>
308-
can have their visual order <a href="#flex-flow-row-reverse">reversed</a> or
308+
can have their display order <a href="#flex-flow-row-reverse">reversed</a> or
309309
<a href="#order-property">rearranged</a> at the style layer
310-
(i.e., display order can be independent of source order)
310+
(i.e., visual order can be independent of source and speech order)
311311
<li>
312312
can be laid out linearly along a single (<i title="main axis">main</i>) axis or
313313
<a href="#flex-wrap-property">wrapped</a> into multiple lines along a secondary (<i title="cross axis">cross</i>) axis
@@ -326,28 +326,28 @@ <h3 id="overview">
326326
Here's an example of a catalog where each item has a title, an photo, a description, and a purchase button.
327327
The designer's intention is that each entry has the same overall size,
328328
that the photo be above the text,
329-
and the purchase buttons aligned at the bottom, regardless of the length of the item's description.
329+
and that the purchase buttons aligned at the bottom, regardless of the length of the item's description.
330330
Flex layout makes many aspects of this design easy:
331331

332332
<ul>
333333
<li>
334-
The catalog uses flex layout to lay out a row of items horizontally,
335-
and to ensure they're all equal-height.
334+
The catalog uses flex layout to lay out rows of items horizontally,
335+
and to ensure that items within a row are all equal-height.
336336
Each entry is then itself a column flex container,
337337
laying out its contents vertically.
338338

339339
<li>
340-
Within each entry, content is ordered logically with the title first,
341-
followed by the description and the photo.
340+
Within each entry, the source document content is ordered logically
341+
with the title first, followed by the description and the photo.
342342
This provides a sensible ordering for speech rendering and in non-CSS browsers.
343343
For a more compelling visual presentation, however,
344344
'order' is used to pull the image up from later in the content to the top,
345-
and 'align-self' to center it horizontally.
345+
and 'align-self' is used to center it horizontally.
346346

347347
<li>
348348
An <a href="#auto-margins">''auto'' margin</a> above the purchase button
349-
forces it to the bottom of the entry box,
350-
regardless of the height of the description.
349+
forces it to the bottom within each entry box,
350+
regardless of the height of that item's description.
351351
</ul>
352352

353353
<pre>

0 commit comments

Comments
 (0)