Re: [webcomponents] added guts of custom elements semantics section (#26)

> @@ -754,6 +756,52 @@ <h2 id="es6">Custom Elements and ECMAScript 6</h2>
>  </ol>
>  </div>
>  
> +<h2 id="semantics">Custom Element Semantics</h2>
> +<p>The default <a href="http://www.w3.org/TR/html/dom.html#semantics-0">semantics</a> of a <a href="#dfn-custom-element">custom element</a> is dependent upon the form in which it is instiantated:</p>
> +<ul>
> +  <li>by default a <a href="#dfn-custom-tag">custom tag</a> has no special meaning at all. It <a href="http://www.w3.org/TR/html/dom.html#represents">represents</a> its children.</li>
> +  <li>by default a <a href="#dfn-type-extension">type extension</a> inherits the semantics of the element type it extends.</li>
> +  </ul>
> +<h3>Custom Tag Semantics</h3>
> +<p>By default a <a href="#dfn-custom-tag">custom tag</a> has no special meaning at all. It <a href="http://www.w3.org/TR/html/dom.html#represents">represents</a> its children.</p>
> +<p>For example a custom tag, could be named <em>taco-button</em> but it does not express the semantics of a HTML <a href="http://www.w3.org/TR/html/forms.html#the-button-element"><code>button</code></a> element simply due to its name. As instaniated a custom tag conveys a similar amount of semantics as a HTML <a href="http://www.w3.org/TR/html/grouping-content.html#the-div-element"><code>div</code></a> or <code><a href="http://www.w3.org/TR/html/text-level-semantics.html#the-span-element">span</a></code> element. The addition of visual styling and scripted events to the <em>taco-button</em> could provide hints as to the semantics and expected interaction behaviours of the custom element for <em>some</em> users, but for the semantics to be formally expressed, developers must convey the role, states and properties of the element to browser APIs.</p>
> +<pre>&lt;!-- taco-button represents a span with a fancy name -->

Brace with ```<code class="prettyprint">``` here and on. See example above (look for "amazement" in text)

---
Reply to this email directly or view it on GitHub:
https://github.com/w3c/webcomponents/pull/26/files#r21466359