DOMs : Add schema to complete the text explanation#1690
DOMs : Add schema to complete the text explanation#1690alemarre wants to merge 1 commit intoPolymer:masterfrom
Conversation
Hi, The text explanation was a bit confusing for me at the first read (a lot a "new" terms : local dom, light dom, shadow dom, shady dom) I think a schema could help understanding
|
Thanks for your pull request. It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA). 📝 Please visit https://cla.developers.google.com/ to sign. Once you've signed, please reply here (e.g.
|
|
I signed it |
|
CLAs look good, thanks! |
| - Shady DOM (Polymer implementation) | ||
| --> | ||
|
|
||
| <content> |
There was a problem hiding this comment.
<content> should be <slot> now...
There was a problem hiding this comment.
This is a suggested edit to a 1.0 doc so it should stay <content>
There was a problem hiding this comment.
so we should keep it <content> even though 1.7+ can make use of slots and reduces changes going to 2.0?
| - Shady DOM (Polymer implementation) | ||
| --> | ||
|
|
||
| <content> |
There was a problem hiding this comment.
This is a suggested edit to a 1.0 doc so it should stay <content>
|
|
||
| </template> | ||
| </dom-module> | ||
| ``` |
There was a problem hiding this comment.
Something seems not quite right about this. I will try to explain my thoughts.
I read the the comments in the <template> section as instructing me to insert my own code here, and that my code must be either:
- A "Shadow DOM (browser implementation)", or
- A "Shady DOM (Polymer implementation)"
I would not know what either of these things are, or how to write them.
Thus I find this suggested addition to be more confusing rather than clarifying.
But I will ask @arthurevans to comment here and will trust his opinion on the matter.
Hi,
The text explanation was a bit confusing for me at the first read (a lot a "new" terms : local dom, light dom, shadow dom, shady dom)
I think a schema could help understanding