From 20d88f9da4354cd39bc6f5116cbbbafe2f78bbdb Mon Sep 17 00:00:00 2001
From: Ian Hickson <ian@hixie.ch>
Date: Tue, 29 Jan 2013 01:21:13 +0000
Subject: [PATCH] [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 | 26 ++++++++++++++++++++++++--
 index         | 26 ++++++++++++++++++++++++--
 source        | 20 ++++++++++++++++++++
 3 files changed, 68 insertions(+), 4 deletions(-)

diff --git a/complete.html b/complete.html
index c5b71142878..6798d1e32c0 100644
--- a/complete.html
+++ b/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>
 
diff --git a/index b/index
index c5b71142878..6798d1e32c0 100644
--- a/index
+++ b/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>
 
diff --git a/source b/source
index 59b852c0fce..94eb0d8fba7 100644
--- a/source
+++ b/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>