Re: [w3c/webcomponents] [shadow-dom] [spec-bug] in asignedNodes description. (#612)

@annevk @hayatoito 

I just looked at https://dom.spec.whatwg.org, and searching for `assignedNodes` unfortunately led to zero results.

The most helpful spec is https://www.w3.org/TR/2015/WD-shadow-dom-20151215, which has useful tables and diagrams clearly explaining how ShadowDOM works, but no such thing can be found at https://dom.spec.whatwg.org.

TLDR,the new docs are not as useful as the old ones, and this is not a helpful situation for the new documentation. Many of that content can be easily copied over though.

I also think moving everything into one gargantuan megadoc is not the best idea. Maybe https://dom.spec.whatwg.org should link to different sub-docs such as https://www.w3.org/TR/2015/WD-shadow-dom-20151215.

At the very least, maybe https://dom.spec.whatwg.org should contain what it currently does, but with links to https://www.w3.org/TR/2015/WD-shadow-dom-20151215 and other sub-specs as necessary. This would make the documentation much better.

-- 
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/612#issuecomment-264723400