This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 21354 - [Explainer]: Web Components explainer actually explaining Custom Elements spec
Summary: [Explainer]: Web Components explainer actually explaining Custom Elements spec
Status: RESOLVED FIXED
Alias: None
Product: WebAppsWG
Classification: Unclassified
Component: HISTORICAL - Component Model (show other bugs)
Version: unspecified
Hardware: PC Windows NT
: P2 normal
Target Milestone: ---
Assignee: Dominic Cooney
QA Contact: public-webapps-bugzilla
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: 14949
  Show dependency tree / graph
 
Reported: 2013-03-20 18:17 UTC by Scott Miles
Modified: 2013-05-30 04:19 UTC (History)
1 user (show)

See Also:

Attachments

Description Scott Miles 2013-03-20 18:17:07 UTC 
Users familiar with this explainer are looking at the Web Components specification (and Web Components polyfills) and becoming confused.

I believe what they really want is the Custom Elements specification (and matching polyfills).

Some way of making this clearer in the explainer (or renaming it) may be a good first step to dispelling FUD.
Comment 1 Dominic Cooney 2013-03-21 06:58:07 UTC 
I think it would be nice if the explainer demonstrated how various specs can be used together. I will work to make it clearer.
Comment 2 Dominic Cooney 2013-05-30 04:19:31 UTC 
I have tried to clarify this.

First, I pushed the links to normative documents out of the preamble and into each of the relevant sections. This should let readers drill down to spec bedrock more quickly.

This also highlights that there is no normative description of Decorators yet, which was reportedly a point of confusion.

Lastly, the document could deliver better on the promise in the introduction. I am working on this.

I believe that this is fixed but please comment and reopen if you can suggest an alternative approach.

<https://dvcs.w3.org/hg/webcomponents/rev/ff4f76002b95>