[webcomponents] The definitions of slot and slot elements are unclear (#306)

> A slot is a defined location where nodes in a different node tree appear instead of the nodes's original position when constructing a composed tree.

There are several undefined terms used in this sentence such as "appear" and "original position".  How something like this?

> A slot is a defined location in a shadow tree into which some of its shadow host's children are inserted as children in its composed tree.

Also, the sentence below the digram says:
> The slot element that satisfies all of the following conditions represents a slot:

while the sentence in the slot element says:
> The slot element represents a slot in the shadow tree.

These two normative statements contradict one another, and I'm not certain what "represents" mean in this context.  I think it's better to say that the slot element that satisfies the two conditions will define a slot at the "location" of the element.  I think there's DOM4 way of saying a location though.  Whatever term we use for "location" should also be defined either in shadow DOM spec or DOM4 spec.

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

Received on Tuesday, 1 September 2015 18:46:40 UTC