hixie: Clarify example text. (whatwg r6927)

hixie: Clarify example text. (whatwg r6927)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5524&r2=1.5525&f=h
http://html5.org/tools/web-apps-tracker?from=6926&to=6927

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5524
retrieving revision 1.5525
diff -u -d -r1.5524 -r1.5525
--- Overview.html 28 Jan 2012 02:01:49 -0000 1.5524
+++ Overview.html 28 Jan 2012 18:20:27 -0000 1.5525
@@ -15074,7 +15074,9 @@
   rank, the <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> element has the lowest rank, and two
   elements with the same name have equal rank.<div class="example">
 
-   <p>These two snippets are equivalent:</p>
+   <p>As far as their respective document outlines (their heading and
+   section structures) are concerned, these two snippets are
+   semantically equivalent:</p>
 
    <pre>&lt;body&gt;
 &lt;h1&gt;Let's call it a draw(ing surface)&lt;/h1&gt;
@@ -15104,6 +15106,10 @@
  &lt;/section&gt;
 &lt;/body&gt;</pre>
 
+   <p>Authors might prefer the former style for its terseness, or the
+   latter style for its convenience in the face of heavy editing;
+   which is besty is purely an issue of preferred authoring style.</p>
+
   </div><h4 id="the-hgroup-element"><span class="secno">4.4.7 </span>The <dfn><code>hgroup</code></dfn> element</h4><dl class="element"><dt><a href="#element-dfn-categories" title="element-dfn-categories">Categories</a>:</dt>
    <dd><a href="#flow-content">Flow content</a>.</dd>
    <dd><a href="#heading-content">Heading content</a>.</dd>
@@ -74721,6 +74727,7 @@
   Peter Beverloo,
   Peter Karlsson,
   Peter Kasting,
+  Peter Moulder,
   Peter Stark,
   Peter-Paul Koch,
   Phil Pickering,

Received on Saturday, 28 January 2012 18:20:59 UTC