[html5] r7666 - [e] (0) Let's try adding even more text explaining article vs section. Affected [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Jan 28 17:21:14 PST 2013
Author: ianh
Date: 2013-01-28 17:21:13 -0800 (Mon, 28 Jan 2013)
New Revision: 7666
Modified:
complete.html
index
source
Log:
[e] (0) Let's try adding even more text explaining article vs section.
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2013-01-29 01:07:38 UTC (rev 7665)
+++ complete.html 2013-01-29 01:21:13 UTC (rev 7666)
@@ -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,8 +18641,28 @@
<strong></footer></strong>
</article></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>
<dl class=element><dt><a href=#element-dfn-categories title=element-dfn-categories>Categories</a>:</dt>
Modified: index
===================================================================
--- index 2013-01-29 01:07:38 UTC (rev 7665)
+++ index 2013-01-29 01:21:13 UTC (rev 7666)
@@ -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,8 +18641,28 @@
<strong></footer></strong>
</article></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>
<dl class=element><dt><a href=#element-dfn-categories title=element-dfn-categories>Categories</a>:</dt>
Modified: source
===================================================================
--- source 2013-01-29 01:07:38 UTC (rev 7665)
+++ source 2013-01-29 01:21:13 UTC (rev 7666)
@@ -19703,6 +19703,26 @@
</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>
More information about the Commit-Watchers
mailing list