<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>16898</bug_id>
          
          <creation_ts>2012-05-01 17:41:06 +0000</creation_ts>
          <short_desc>[Shadow]: Normative requirements</short_desc>
          <delta_ts>2012-05-14 22:52:31 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebAppsWG</product>
          <component>HISTORICAL - Component Model</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          <blocked>17050</blocked>
          <everconfirmed>1</everconfirmed>
          <reporter name="Anne">annevk</reporter>
          <assigned_to name="Dimitri Glazkov">dglazkov</assigned_to>
          
          
          <qa_contact>public-webapps-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>67219</commentid>
    <comment_count>0</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2012-05-01 17:41:06 +0000</bug_when>
    <thetext>The ShadowRoot constructor has no must-level requirements and the same goes for other parts of the specification. Look at e.g. DOM/XMLHttpRequest/HTML for ideas on how to address this.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67626</commentid>
    <comment_count>1</comment_count>
    <who name="Dimitri Glazkov">dglazkov</who>
    <bug_when>2012-05-11 23:21:22 +0000</bug_when>
    <thetext>http://dvcs.w3.org/hg/webcomponents/rev/822d9cdf8db8, what do you think of constructor changes?

It looks like I need to make each attribute/method a sub-section and specify what happens on invokation/getting/setting. I&apos;ll do that next.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67631</commentid>
    <comment_count>2</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2012-05-12 09:31:16 +0000</bug_when>
    <thetext>I don&apos;t think they necessarily need to be a subsection. That was done for XMLHttpRequest because the descriptions are rather elaborate, but whether that&apos;s the best division is not entirely clear to me.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67632</commentid>
    <comment_count>3</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2012-05-12 09:35:23 +0000</bug_when>
    <thetext>The new constructor text looks okay, although parameters are typically marked up as &lt;var&gt;, not &lt;code&gt;, and using a &lt;dl&gt;/&lt;table&gt; structure to define something as simple as this seems wrong. (In most specifications a constructor/method/attribute is defined as a &lt;p&gt;/&lt;ol&gt; structure preceded by a &lt;dl class=domintro&gt; box.)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67699</commentid>
    <comment_count>4</comment_count>
    <who name="Dimitri Glazkov">dglazkov</who>
    <bug_when>2012-05-14 22:52:31 +0000</bug_when>
    <thetext>http://dvcs.w3.org/hg/webcomponents/rev/d6134e2e897e</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>