<?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>9358</bug_id>
          
          <creation_ts>2010-03-28 21:01:16 +0000</creation_ts>
          <short_desc>Explanation of content model requirements could be improved</short_desc>
          <delta_ts>2010-10-04 14:28:12 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>pre-LC1 HTML5 spec (editor: Ian Hickson)</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc>http://dev.w3.org/html5/spec/Overview.html#conformance-requirements-for-authors</bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Maciej Stachowiak">mjs</reporter>
          <assigned_to name="Ian &apos;Hixie&apos; Hickson">ian</assigned_to>
          <cc>ayg</cc>
    
    <cc>ian</cc>
    
    <cc>mike</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>34000</commentid>
    <comment_count>0</comment_count>
    <who name="Maciej Stachowiak">mjs</who>
    <bug_when>2010-03-28 21:01:16 +0000</bug_when>
    <thetext>Section 1.9 Conformance requirements for authors explains the reason for many conformance requirements.

Here are a few content model errors found on real sites that I am not sure are adequately explained:

* &lt;div&gt; as a child of &lt;h2&gt; or &lt;h3&gt; (in general the fact that headers allow only phrasing content, not flow content)
* &lt;div&gt; as a child of &lt;span&gt; - this seems fairly common, perhaps because it was allowed by HTML4; since &lt;div&gt; has no semantics, it&apos;s not obviously a semantic error
* Nested interactive elements (&lt;a&gt; inside &lt;a&gt;, &lt;button&gt; inside &lt;a&gt;, etc)
* &lt;form&gt; in &lt;span&gt;
* &lt;dl&gt; and &lt;ul&gt; only being allowed to contain their specific children.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>34496</commentid>
    <comment_count>1</comment_count>
    <who name="Maciej Stachowiak">mjs</who>
    <bug_when>2010-04-04 08:15:26 +0000</bug_when>
    <thetext>(In reply to comment #0)
&gt; * &lt;div&gt; as a child of &lt;span&gt; - this seems fairly common, perhaps because it was
&gt; allowed by HTML4; since &lt;div&gt; has no semantics, it&apos;s not obviously a semantic
&gt; error

I was mistaken - HTML4 does not allow it. It would still be helpful to ensure that the reason for this restriction is sufficiently explained.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>34497</commentid>
    <comment_count>2</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2010-04-04 08:54:31 +0000</bug_when>
    <thetext>&gt; * &lt;div&gt; as a child of &lt;h2&gt; or &lt;h3&gt; (in general the fact that headers allow only
&gt; phrasing content, not flow content)

&quot;Errors that flag content with dubious semantics&quot;


&gt; * &lt;div&gt; as a child of &lt;span&gt;

Added &quot;Errors that catch cases where the default styles are likely to lead to confusion&quot;.


&gt; * Nested interactive elements (&lt;a&gt; inside &lt;a&gt;, &lt;button&gt; inside &lt;a&gt;, etc)

Covered by the new &quot;Errors that catch cases where the default styles are likely to lead to confusion&quot;.


&gt; * &lt;form&gt; in &lt;span&gt;

Added &quot;Errors that avoid peculiarities of the parser&quot;.


&gt; * &lt;dl&gt; and &lt;ul&gt; only being allowed to contain their specific children.

&quot;Errors that indicate a conflict in expressed semantics&quot;.


EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are satisfied with this response, please change the state of this bug to CLOSED. If you have additional information and would like the editor to reconsider, please reopen this bug. If you would like to escalate the issue to the full HTML Working Group, please add the TrackerRequest keyword to this bug, and suggest title and text for the tracker issue; or you may create a tracker issue yourself, if you are able to do so. For more details, see this document:
   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: Accepted
Change Description: see diff given below - added examples and the aforementioned new sections
Rationale: Concurred with reporter&apos;s comments.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>34498</commentid>
    <comment_count>3</comment_count>
    <who name="">contributor</who>
    <bug_when>2010-04-04 08:56:59 +0000</bug_when>
    <thetext>Checked in as WHATWG revision r4966.
Check-in comment: More information on the reasons for authoring conformance criteria. I can&apos;t wait to see other W3C and IETF specs, like SVG, Atom, or RDFa, include introduction sections explaining why _they_ all have authoring conformance criteria.
http://html5.org/tools/web-apps-tracker?from=4965&amp;to=4966</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>34499</commentid>
    <comment_count>4</comment_count>
    <who name="Maciej Stachowiak">mjs</who>
    <bug_when>2010-04-04 09:03:30 +0000</bug_when>
    <thetext>Looks good to me.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>