@@ -135,6 +135,8 @@ Introduction</h2>
135135<h2 id='overview'>
136136Overview</h2>
137137
138+ <em> This section is not normative.</em>
139+
138140 Grid Layout controls the layout of its content
139141 through the use of a <a>grid</a> :
140142 an intersecting set of horizontal and vertical lines
@@ -301,6 +303,7 @@ Sizing the Grid</h3>
301303 Finally each <a>grid item</a> is sized and aligned within its assigned <a>grid area</a> ,
302304 as specified by its own sizing and alignment properties.
303305
306+
304307<h3 id='background'>
305308Background and Motivation</h3>
306309
@@ -323,11 +326,15 @@ Background and Motivation</h3>
323326 It provides a mechanism for authors to divide available space for layout into columns and rows
324327 using a set of predictable sizing behaviors.
325328 Authors can then precisely position and size the building block elements of their application
326- into <a>grid areas</a> defined by the intersection of these columns and rows.
327- Figure 1 illustrates a basic layout which can be achieved with grid layout.
329+ into the <a>grid areas</a> defined by the intersections of these columns and rows.
330+
331+ <h3 id="overview-examples">
332+ Sample Use Cases</h3>
328333
329- <h3 id='adapting-to-available-space'>
330- Adapting Layouts to Available Space</h3>
334+ <em> This section is not normative.</em>
335+
336+ <h4 id='adapting-to-available-space'>
337+ Adapting Layouts to Available Space</h4>
331338
332339 <figure class="sidefigure">
333340 <img alt="Image: Five grid items arranged according to content size and available space." src="images/game-smaller.png" />
@@ -341,8 +348,8 @@ Adapting Layouts to Available Space</h3>
341348 <figcaption> Growth in the grid due to an increase in available space.</figcaption>
342349 </figure>
343350
344- Grid layout can be used to intelligently reflow elements within a webpage.
345- Figure 2 and 3 represents a game with five major components in the layout:
351+ Grid layout can be used to intelligently resize elements within a webpage.
352+ The figures above represent a game with five major components in the layout:
346353 the game title, stats area, game board, score area, and control area.
347354 The author's intent is to divide the space for the game such that:
348355
@@ -356,7 +363,7 @@ Adapting Layouts to Available Space</h3>
356363 <li>
357364 The bottom of the game board and bottom of the stats area align when the game has reached its minimum height.
358365 In all other cases the game board will stretch to take advantage of all the space available to it.
359- <li>
366+ <li>
360367 The controls are centered under the game board.
361368 <li>
362369 The top of the score area is aligned to the top of the controls area.
@@ -366,15 +373,15 @@ Adapting Layouts to Available Space</h3>
366373 The score area is aligned to the controls beneath the stats are.
367374 </ul>
368375
369- The following example shows how an author might achieve all the sizing, placement, and alignment rules declaratively.
376+ The following grid layout example shows how an author might achieve
377+ all the sizing, placement, and alignment rules declaratively.
370378
371379
372380 <div class="example">
373381 <pre class="lang-css">
374382 /**
375- * This example illustrates one that an author may use to define the position and space for each <a>grid item</a>
376- * using the 'grid-template-rows' and 'grid-template-columns' properties on the <a>grid container</a> ,
377- * and the 'grid-row' and 'grid-column' properties on each <a>grid item</a> .
383+ * Define the space for each <a>grid item</a> by declaring the grid
384+ * on the <a>grid container</a> .
378385 */
379386 #grid {
380387 /**
@@ -401,10 +408,9 @@ Adapting Layouts to Available Space</h3>
401408 /* 5 */ auto;
402409 }
403410
404- /* Each part of the game is positioned between grid lines. It's achieved by
405- * referencing the starting grid line and then specifying, if more
406- * than one, the number of rows or columns spanned to determine
407- * the ending grid line, which establishes bounds for the area. */
411+ /* Specify the position of each <a>grid item</a> using coordinates on
412+ * the 'grid-row' and 'grid-column' properties of each <a>grid item</a> .
413+ */
408414 #title { grid-column: 1; grid-row: 1; }
409415 #score { grid-column: 1; grid-row: 3; }
410416 #stats { grid-column: 1; grid-row: 2; align-self: start; }
@@ -427,8 +433,8 @@ Adapting Layouts to Available Space</h3>
427433 and to position and size <a>grid items</a> ,
428434 each optimized for different scenarios.
429435
430- <h3 id='source-independence'>
431- Source-Order Independence</h3 >
436+ <h4 id='source-independence'>
437+ Source-Order Independence</h4 >
432438
433439 <figure class="sidefigure">
434440 <img alt="Image: An arrangement suitable for portrait orientation." src="images/game-portrait.png" />
@@ -523,8 +529,8 @@ Source-Order Independence</h3>
523529 as a substitute for correct source ordering,
524530 as that can ruin the accessibility of the document.
525531
526- <h3 id='grid-layering'>
527- Grid Layering of Elements</h3 >
532+ <h4 id='grid-layering'>
533+ Grid Layering of Elements</h4 >
528534
529535 <figure class="sidefigure">
530536 <img alt="Image: A control composed of layered HTML elements." src="images/control-layering-and-alignment.png" />
0 commit comments