[e] (0) Clarify example text.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=15176 Affected topics: HTML git-svn-id: http://svn.whatwg.org/webapps@6927 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jan 28, 2012 · a095604 · a095604
1 parent 99ed79c
commit a095604
Show file tree

Hide file tree

Showing 3 changed files with 24 additions and 3 deletions.
diff --git a/complete.html b/complete.html
@@ -18027,7 +18027,9 @@ <h4 id=the-h1,-h2,-h3,-h4,-h5,-and-h6-elements><span class=secno>4.4.6 </span>Th
 
   <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;
@@ -18057,6 +18059,10 @@ <h4 id=the-h1,-h2,-h3,-h4,-h5,-and-h6-elements><span class=secno>4.4.6 </span>Th
  &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>
 
 
@@ -98453,6 +98459,7 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
   Peter Beverloo,
   Peter Karlsson,
   Peter Kasting,
+  Peter Moulder,
   Peter Stark,
   Peter-Paul Koch,
   Phil Pickering,

diff --git a/index b/index
@@ -18027,7 +18027,9 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
 
   <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;
@@ -18057,6 +18059,10 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
  &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>
 
 
@@ -98453,6 +98459,7 @@ if (s = prompt('What is your name?')) {
   Peter Beverloo,
   Peter Karlsson,
   Peter Kasting,
+  Peter Moulder,
   Peter Stark,
   Peter-Paul Koch,
   Phil Pickering,

diff --git a/source b/source
@@ -19318,7 +19318,9 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
 
   <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>
 &lt;h1>Let's call it a draw(ing surface)&lt;/h1>
@@ -19348,6 +19350,10 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
  &lt;/section>
 &lt;/body></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>
 
 
@@ -115334,6 +115340,7 @@ if (s = prompt('What is your name?')) {
   Peter Beverloo,
   Peter Karlsson,
   Peter Kasting,
+  Peter Moulder,
   Peter Stark,
   Peter-Paul Koch,
   Phil Pickering,