[e] (0) Let's try adding even more text explaining article vs section.

Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@7666 340c8d12-0b0e-0410-8428-c7bf67bfef74

complete.html

@@ -484,7 +484,9 @@ <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 29 January 2013</
      <li><a href=#headings-and-sections><span class=secno>4.4.11 </span>Headings and sections</a>
       <ol>
        <li><a href=#outlines><span class=secno>4.4.11.1 </span>Creating an outline</a></ol></li>
-     <li><a href=#usage-summary-0><span class=secno>4.4.12 </span>Usage summary</a></ol></li>
+     <li><a href=#usage-summary-0><span class=secno>4.4.12 </span>Usage summary</a>
+      <ol>
+       <li><a href=#article-or-section?><span class=secno>4.4.12.1 </span>Article or section?</a></ol></ol></li>
    <li><a href=#grouping-content><span class=secno>4.5 </span>Grouping content</a>
     <ol>
      <li><a href=#the-p-element><span class=secno>4.5.1 </span>The <code>p</code> element</a></li>
@@ -18639,7 +18641,27 @@ <h4 id=usage-summary-0><span class=secno>4.4.12 </span>Usage summary</h4>
  <strong>&lt;/footer&gt;</strong>
 &lt;/article&gt;</pre>
 
-  </table><h3 id=grouping-content><span class=secno>4.5 </span>Grouping content</h3>
+  </table><h5 id=article-or-section?><span class=secno>4.4.12.1 </span>Article or section?</h5>
+
+  <p><i>This section is non-normative.</i></p>
+
+  <p>A <code><a href=#the-section-element>section</a></code> forms part of something else. An <code><a href=#the-article-element>article</a></code> is its own thing.
+  But how does one know which is which? Mostly the real answer is "it depends on author intent".</p>
+
+  <p>For example, one could imagine a book with a "Granny Smith" chapter that just said "These
+  juicy, green apples make a great filling for apple pies."; that would be a <code><a href=#the-section-element>section</a></code>
+  because there'd be lots of other chapters on (maybe) other kinds of apples.</p>
+
+  <p>On the other hand, one could imagine a tweet or reddit comment or tumblr post or newspaper
+  classified ad that just said "Granny Smith. These juicy, green apples make a great filling for
+  apple pies."; it would then be <code><a href=#the-article-element>article</a></code>s because that was the whole thing.</p>
+
+  <p>A comment on an article is not part of the <code><a href=#the-article-element>article</a></code> on which it is commenting,
+  therefore it is its own <code><a href=#the-article-element>article</a></code>.</p>
+
+
+
+  <h3 id=grouping-content><span class=secno>4.5 </span>Grouping content</h3>
 
   <h4 id=the-p-element><span class=secno>4.5.1 </span>The <dfn><code>p</code></dfn> element</h4>
 

index

@@ -484,7 +484,9 @@
      <li><a href=#headings-and-sections><span class=secno>4.4.11 </span>Headings and sections</a>
       <ol>
        <li><a href=#outlines><span class=secno>4.4.11.1 </span>Creating an outline</a></ol></li>
-     <li><a href=#usage-summary-0><span class=secno>4.4.12 </span>Usage summary</a></ol></li>
+     <li><a href=#usage-summary-0><span class=secno>4.4.12 </span>Usage summary</a>
+      <ol>
+       <li><a href=#article-or-section?><span class=secno>4.4.12.1 </span>Article or section?</a></ol></ol></li>
    <li><a href=#grouping-content><span class=secno>4.5 </span>Grouping content</a>
     <ol>
      <li><a href=#the-p-element><span class=secno>4.5.1 </span>The <code>p</code> element</a></li>
@@ -18639,7 +18641,27 @@ Space is not the only void</pre>
  <strong>&lt;/footer&gt;</strong>
 &lt;/article&gt;</pre>
 
-  </table><h3 id=grouping-content><span class=secno>4.5 </span>Grouping content</h3>
+  </table><h5 id=article-or-section?><span class=secno>4.4.12.1 </span>Article or section?</h5>
+
+  <p><i>This section is non-normative.</i></p>
+
+  <p>A <code><a href=#the-section-element>section</a></code> forms part of something else. An <code><a href=#the-article-element>article</a></code> is its own thing.
+  But how does one know which is which? Mostly the real answer is "it depends on author intent".</p>
+
+  <p>For example, one could imagine a book with a "Granny Smith" chapter that just said "These
+  juicy, green apples make a great filling for apple pies."; that would be a <code><a href=#the-section-element>section</a></code>
+  because there'd be lots of other chapters on (maybe) other kinds of apples.</p>
+
+  <p>On the other hand, one could imagine a tweet or reddit comment or tumblr post or newspaper
+  classified ad that just said "Granny Smith. These juicy, green apples make a great filling for
+  apple pies."; it would then be <code><a href=#the-article-element>article</a></code>s because that was the whole thing.</p>
+
+  <p>A comment on an article is not part of the <code><a href=#the-article-element>article</a></code> on which it is commenting,
+  therefore it is its own <code><a href=#the-article-element>article</a></code>.</p>
+
+
+
+  <h3 id=grouping-content><span class=secno>4.5 </span>Grouping content</h3>
 
   <h4 id=the-p-element><span class=secno>4.5.1 </span>The <dfn><code>p</code></dfn> element</h4>
 

source

@@ -19703,6 +19703,26 @@ Space is not the only void</pre>
   </table>
 
 
+  <h5>Article or section?</h5>
+
+  <!--END dev-html--><p><i>This section is non-normative.</i></p><!--START dev-html-->
+
+  <p>A <code>section</code> forms part of something else. An <code>article</code> is its own thing.
+  But how does one know which is which? Mostly the real answer is "it depends on author intent".</p>
+
+  <p>For example, one could imagine a book with a "Granny Smith" chapter that just said "These
+  juicy, green apples make a great filling for apple pies."; that would be a <code>section</code>
+  because there'd be lots of other chapters on (maybe) other kinds of apples.</p>
+
+  <p>On the other hand, one could imagine a tweet or reddit comment or tumblr post or newspaper
+  classified ad that just said "Granny Smith. These juicy, green apples make a great filling for
+  apple pies."; it would then be <code>article</code>s because that was the whole thing.</p>
+
+  <p>A comment on an article is not part of the <code>article</code> on which it is commenting,
+  therefore it is its own <code>article</code>.</p>
+
+
+
   <h3>Grouping content</h3>
 
   <h4>The <dfn><code>p</code></dfn> element</h4>