Re: [w3c/webcomponents] Figure out terminology for Shadow DOM that everyone agrees on (#382)

If someone asks me what a "flat tree" or "composed tree" is when I am describing Shadow DOM to them, where am I supposed to send them now?

Or what concept should I use in place of those instead "composed tree" or "flat tree"?

The original document, for example https://www.w3.org/TR/2015/WD-shadow-dom-20151006/, was nice because it explained the topic more clearly and with visual diagrams.

But now, those documents are "outdated", and clicking forward to the new documents leads to a place that is less helpful, does not include concise descriptions of the concepts, and does not include tree diagrams. It seems to be a regression in terms of helping people understand how the concepts work (like the original document did).

It seems virtually impossible for (especially new) people to learn (from official documents) what ShadowDOM is, and how the tree works and how it renders (f.e. rendering from the "flat tree").

Have I missed another document somewhere?

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/w3c/webcomponents/issues/382#issuecomment-629883777