From 17c9ad19127e2bbe9c9c4a03019e260d9b7bfa09 Mon Sep 17 00:00:00 2001
From: fantasai <fantasai.bugs@inkedblade.net>
Date: Tue, 29 Jan 2019 17:04:37 -0800
Subject: [PATCH] [css-grid-1] Improve description of 'auto' track sizes. #3571

---
 css-grid-1/Overview.bs | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/css-grid-1/Overview.bs b/css-grid-1/Overview.bs
index 381b823f8ca..d96d7c186e0 100644
--- a/css-grid-1/Overview.bs
+++ b/css-grid-1/Overview.bs
@@ -1485,12 +1485,25 @@ Explicit Track Sizing: the 'grid-template-rows' and 'grid-template-columns' prop
 
 		<dt><dfn>auto</dfn>
 		<dd>
-			As a maximum, identical to ''max-content''.
-			As a minimum, represents the largest minimum size (as specified by 'min-width'/'min-height')
+			As a <em>maximum</em>: represents the largest <a>max-content contribution</a>
+			of the <a>grid items</a> occupying the <a>grid track</a>;
+			however, unlike ''max-content'',
+			allows expansion of the track
+			by the 'align-content' and 'justify-content' properties.
+
+			As a <em>minimum</em>: represents the largest <a>minimum size</a>
+			(specified by 'min-width'/'min-height')
 			of the <a>grid items</a> occupying the <a>grid track</a>.
-
-			Note: ''grid-template-rows/auto'' track sizes (and only ''grid-template-rows/auto'' track sizes)
-			can be stretched by the 'align-content' and 'justify-content' properties.
+			(This initially is often, but not always,
+			equal to a ''min-content'' minimum--
+			see [[#min-size-auto]].)
+
+			When appearing outside a ''minmax()'' notation:
+			equivalent to ''minmax(auto, auto)'',
+			representing the range between
+			the minimum and maximum described above.
+			(This behaves similar to ''minmax(min-content, max-content)'' in the most basic cases,
+			but with extra abilities.)
 
 		<dt><dfn lt="fit-content()">fit-content( <<length-percentage>> )</dfn>
 		<dd>