[webcomponents] [Shadow]: Multiple trees are introduced to explain encapsulation. (bugzilla: 23481) (#83)

Title: [Shadow]: Multiple trees are introduced to explain encapsulation. (bugzilla: 23481)

Migrated from: https://www.w3.org/Bugs/Public/show_bug.cgi?id=23481

----
comment: 0
comment_url: https://www.w3.org/Bugs/Public/show_bug.cgi?id=23481#c0
*johnjbarton* wrote on 2013-10-10 16:09:11 +0000.

" Encapsulation is effectively a natural property of having multiple trees."

I pondered the first part of this document for a long while: "tree of trees" makes no sense. Graphically, a tree of trees is just a tree. Look at all the diagrams in the first part of the doc: just trees with solid or dotted lines and some superfluous-looking boxes.

Eventually it came to me: 'tree of trees' was invented to explain that parts of the tree are encapsulated from other parts.  Eventually this was confirmed in the quote above.

The story would be much clearer if you say that right when you introduce the neology 'tree of trees'.  Rather than starting with complicated definitions, just say that the Shadow DOM spec defines new encapsulated DOM sub-trees. When we introduce this encapsulated sub-tree into the existing DOM tree, we call the result a 'tree of trees' to emphasis the encapsulation while also showing that tree navigation operation existed between pre-shadow-DOM nodes and Shadow DOM nodes.

----

comment: 1
comment_url: https://www.w3.org/Bugs/Public/show_bug.cgi?id=23481#c1
*Yuta Kitamura* wrote on 2013-10-22 07:00:51 +0000.

Yeah, I agree that inter-tree interactions are not very obvious. I think
it's the specification's job to explain the "naturalness" in written form.

---
Reply to this email directly or view it on GitHub:
https://github.com/w3c/webcomponents/issues/83