[css-grid-3] Define normal initial value for orientation property. w3c#12803

Author: fantasai

css-grid-3/Overview.bs

@@ -363,6 +363,50 @@ Establishing Grid Lanes Layout</h3>
 	ISSUE(12820): Write up how grid/masonry formatting contexts work more formally?
 	</div>
 
+<h3 id="grid-lanes-orientation">
+Orienting Grid Lanes Layout</h3>
+
+	The orientation of a [=grid lanes container=],
+	i.e. whether its [=grid axis=] is
+	the [=inline axis=] (establishing columns)
+	or the [=block axis=] (establishing rows)
+	is determined by the <span class="issue">TBD</span> property.
+
+	The [=initial value=] of this property is <dfn value for=grid-auto-flow>normal</dfn>,
+	which determines the orientation from the 'grid-template-*' properties:
+
+	* If 'grid-template-columns' is ''grid-template-columns/none''
+		and 'grid-template-rows' is not ''grid-template-rows/none'',
+		the [=grid container=]’s [=block axis=] is the [=grid axis=] (establishing rows).
+	* Otherwise (thus by default),
+		the [=grid container=]’s [=inline axis=] is the [=grid axis=] (establishing columns).
+
+	<div class="example">
+		The following code will create a 2-column (“waterfall style”) [=grid lanes container=]
+		that grows downward:
+
+		<pre class=css>
+		.container {
+			display: grid-lanes;
+			grid-template-<strong>columns</strong>: 100px 200px;
+		}
+		</pre>
+
+		while the following code will create a 2-row (“brick wall style”) [=grid lanes container=]
+		that grows horizontally:
+
+		<pre class=css>
+		.container {
+			display: grid-lanes;
+			grid-template-<strong>rows</strong>: 100px 200px;
+		}
+		</pre>
+	</div>
+
+	ISSUE(12803): Figure out whether we are re-using 'grid-auto-flow' here
+	(and what it's values mean)
+	or defining a new property like <css>grid-lanes-direction</css>.
+
 <h2 id="grid-lanes-track-templates" oldids="masonry-track-templates">
 Grid Lanes Track Specification</h2>
 
@@ -676,7 +720,7 @@ Optimized Track Sizing</h4>
 	<a href="https://github.com/w3c/csswg-drafts/issues">report it to the CSSWG</a>.
 
 <h2 id="grid-lanes-track-placement" oldids="masonry-track-placement">
-Grid Lanes Track Placement</h2>
+Grid Lanes Item Placement</h2>
 
 	In the [=grid axis=],
 	items can be <em>explicitly placed</em> into tracks and span them using the familiar [=grid-placement properties=]’ syntax.
@@ -1070,8 +1114,10 @@ Alignment and Spacing</h2>
 	the [=grid container=]'s [=content box=] in the [=stacking axis=],
 	then the [=stacking range=] will be larger than the [=grid container=]'s [=content box=].
 
-	ISSUE: Should alignment in the stacking axis do something more sophisticated?
-	What should that be?
+
+
+	ISSUE(10275): Is this a reasonable definition for how the [=self-alignment properties=] should work in the [=stacking axis=]?
+
 
 <h3 id="grid-lanes-baseline-alignment" oldids="masonry-baseline-alignment">
 Baseline Alignment</h3>