[css-display] Actually add some explanatory text to display-inside/outside.

Author: tabatkins

css-display/Overview.bs

@@ -81,6 +81,11 @@ Telling Contents How to Lay Out: the 'display-inside' property</h3>
 	Media: all
 	</pre>
 
+	The 'display-inside' property specifies the <dfn export>inner display type</dfn>
+	of the box generated by the element,
+	dictating how its contents lay out
+	inside the box.
+
 	<dl dfn-type="value" dfn-for="display-inside">
 		<dt><dfn>auto</dfn>
 		<dd>
@@ -127,6 +132,10 @@ Interacting with Ancestors and Siblings: the 'display-outside' property</h3>
 	Media: all
 	</pre>
 
+	The 'display-outside' property specifies the <dfn export>outer display type</dfn>
+	of the box generated by the element,
+	dictating how the element participates in its parent formatting context.
+
 	<dl dfn-type="value" dfn-for="display-outside">
 		<dt><dfn>block-level</dfn>
 		<dd>

css-display/Overview.html

@@ -204,6 +204,11 @@ <h3 class="heading settled" data-level=2.1 id=the-display-inside><span class=sec
 
 <table class="definition propdef"><tr><th>Name:<td><dfn class=css data-dfn-type=property data-export="" id=propdef-display-inside>display-inside<a class=self-link href=#propdef-display-inside></a></dfn><tr><th>Value:<td class=prod>auto <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> block <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> flex <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> grid <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> ruby<tr><th>Initial:<td>auto<tr><th>Applies to:<td>all elements<tr><th>Inherited:<td>no<tr><th>Media:<td>all<tr><th>Computed value:<td>a keyword<tr><th>Percentages:<td>n/a</table>
 
+<p>The <a class=property data-link-type=propdesc href=#propdef-display-inside title=display-inside>display-inside</a> property specifies the <dfn data-dfn-type=dfn data-export="" id=inner-display-type>inner display type<a class=self-link href=#inner-display-type></a></dfn>
+	of the box generated by the element,
+	dictating how its contents lay out
+	inside the box.</p>
+
 	<dl data-dfn-for=display-inside data-dfn-type=value>
 		<dt><dfn class=css data-dfn-for=display-inside data-dfn-type=value data-export="" id=valdef-display-inside-auto>auto<a class=self-link href=#valdef-display-inside-auto></a></dfn>
 		<dd>
@@ -241,6 +246,10 @@ <h3 class="heading settled" data-level=2.2 id=the-display-outside><span class=se
 
 <table class="definition propdef"><tr><th>Name:<td><dfn class=css data-dfn-type=property data-export="" id=propdef-display-outside>display-outside<a class=self-link href=#propdef-display-outside></a></dfn><tr><th>Value:<td class=prod>block-level <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> inline-level <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> run-in <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> contents <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> none <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-row-group <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-header-group <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-footer-group <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-row <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-cell <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-column-group <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-column <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> table-caption <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> ruby-base <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> ruby-text <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> ruby-base-container <a class=prod-punc data-link-type=grammar href=http://dev.w3.org/csswg/css-values-3/#comb-one title=|>|</a> ruby-text-container<tr><th>Initial:<td>inline-level<tr><th>Applies to:<td>all elements<tr><th>Inherited:<td>no<tr><th>Media:<td>all<tr><th>Computed value:<td>as specified<tr><th>Percentages:<td>n/a</table>
 
+<p>The <a class=property data-link-type=propdesc href=#propdef-display-outside title=display-outside>display-outside</a> property specifies the <dfn data-dfn-type=dfn data-export="" id=outer-display-type>outer display type<a class=self-link href=#outer-display-type></a></dfn>
+	of the box generated by the element,
+	dictating how the element participates in its parent formatting context.</p>
+
 	<dl data-dfn-for=display-outside data-dfn-type=value>
 		<dt><dfn class=css data-dfn-for=display-outside data-dfn-type=value data-export="" id=valdef-display-outside-block-level>block-level<a class=self-link href=#valdef-display-outside-block-level></a></dfn>
 		<dd>
@@ -747,6 +756,7 @@ <h2 class="no-num no-ref heading settled" id=index><span class=content>
 <li>inline-table, <a href=#valdef-display-inline-table title="section 2.4">2.4</a>
 <li>inlinification, <a href=#inlinify title="section 2.5">2.5</a>
 <li>inlinify, <a href=#inlinify title="section 2.5">2.5</a>
+<li>inner display type, <a href=#inner-display-type title="section 2.1">2.1</a>
 <li>internal ruby element, <a href=#internal-ruby-element title="section 2.2">2.2</a>
 <li>internal table element, <a href=#internal-table-element title="section 2.2">2.2</a>
 <li>layout-specific internal types, <a href=#layout-specific-internal-types title="section 2.2">2.2</a>
@@ -755,7 +765,8 @@ <h2 class="no-num no-ref heading settled" id=index><span class=content>
 <li>value for display, <a href=#valdef-display-list-item title="section 2.4">2.4</a>
 </ul><li>none<ul><li>value for display-outside, <a href=#valdef-display-outside-none title="section 2.2">2.2</a>
 <li>value for display, <a href=#valdef-display-none title="section 2.4">2.4</a>
-</ul><li>ruby<ul><li>value for display-inside, <a href=#valdef-display-inside-ruby title="section 2.1">2.1</a>
+</ul><li>outer display type, <a href=#outer-display-type title="section 2.2">2.2</a>
+<li>ruby<ul><li>value for display-inside, <a href=#valdef-display-inside-ruby title="section 2.1">2.1</a>
 <li>value for display, <a href=#valdef-display-ruby title="section 2.4">2.4</a>
 </ul><li>ruby-base, <a href=#valdef-display-outside-ruby-base title="section 2.2">2.2</a>
 <li>ruby-base-container, <a href=#valdef-display-outside-ruby-base-container title="section 2.2">2.2</a>