[shadow-styling] dfn shadow root

Author: tabatkins

shadow-styling/Overview.bs

@@ -26,6 +26,8 @@ Shadow Trees</h3>
 
 	A <dfn export>shadow tree</dfn> is a document fragment
 	that can be attached to any element in the DOM.
+	The root of the <a>shadow tree</a> is a <dfn export>shadow root</dfn>,
+	a non-element node which is associated with a <a>shadow host</a>.
 	An element can have any number of <a>shadow trees</a>,
 	which are ordered by creation time.
 	The most recently-created <a>shadow tree</a> on an element
@@ -35,7 +37,7 @@ Shadow Trees</h3>
 	It is the <dfn export>host element</dfn> for its shadow trees.
 
 	The descendants of a <a>shadow host</a>
-	must not generate boxes as normal.
+	must not generate boxes in the formatting tree.
 	Instead, the contents of the <a>active shadow tree</a> generates boxes
 	as if it were the contents of the element instead.
 

shadow-styling/Overview.html

@@ -160,6 +160,8 @@ <h3 class="heading settled heading" data-level=2.1 id=shadow-trees><span class=s
 
 <p>	A <dfn data-dfn-type=dfn data-export="" id=shadow-tree>shadow tree<a class=self-link href=#shadow-tree></a></dfn> is a document fragment
 	that can be attached to any element in the DOM.
+	The root of the <a data-link-type=dfn href=#shadow-tree title="shadow tree">shadow tree</a> is a <dfn data-dfn-type=dfn data-export="" id=shadow-root>shadow root<a class=self-link href=#shadow-root></a></dfn>,
+	a non-element node which is associated with a <a data-link-type=dfn href=#shadow-host title="shadow host">shadow host</a>.
 	An element can have any number of <a data-link-type=dfn href=#shadow-tree title="shadow trees">shadow trees</a>,
 	which are ordered by creation time.
 	The most recently-created <a data-link-type=dfn href=#shadow-tree title="shadow tree">shadow tree</a> on an element
@@ -169,13 +171,13 @@ <h3 class="heading settled heading" data-level=2.1 id=shadow-trees><span class=s
 	It is the <dfn data-dfn-type=dfn data-export="" id=host-element0>host element<a class=self-link href=#host-element0></a></dfn> for its shadow trees.
 
 <p>	The descendants of a <a data-link-type=dfn href=#shadow-host title="shadow host">shadow host</a>
-	must not generate boxes as normal.
+	must not generate boxes in the formatting tree.
 	Instead, the contents of the <a data-link-type=dfn href=#active-shadow-tree title="active shadow tree">active shadow tree</a> generates boxes
 	as if it were the contents of the element instead.
 
 <p>	In several instances in shadow DOM,
 	elements don’t have element parents
-	(instead, they may have a <a data-link-type=dfn title="shadow root">shadow root</a> as parent,
+	(instead, they may have a <a data-link-type=dfn href=#shadow-root title="shadow root">shadow root</a> as parent,
 		or something else).
 	An element without a parent,
 	or whose parent is not an element,
@@ -688,6 +690,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 <li>/shadow/, <a href=#selectordef-shadow0 title="section 5.1">5.1</a>
 <li>/shadow-deep/, <a href=#selectordef-shadow-deep title="section 5.2">5.2</a>
 <li>shadow host, <a href=#shadow-host title="section 2.1">2.1</a>
+<li>shadow root, <a href=#shadow-root title="section 2.1">2.1</a>
 <li>shadow tree, <a href=#shadow-tree title="section 2.1">2.1</a>
 <li>top-level element, <a href=#top-level-element title="section 2.1">2.1</a>
 </ul></div>