[html5] r3779 - [e] (0) Try to reduce the confusion caused by implied paragraphs and <ins>/<del> [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2009-09-09 03:16:14 -0700 (Wed, 09 Sep 2009)
New Revision: 3779

Modified:
   index
   source
Log:
[e] (0) Try to reduce the confusion caused by implied paragraphs and <ins>/<del>, by making some sections non-normative, and clearly marking bad examples.

Modified: index
===================================================================
--- index	2009-09-09 09:59:29 UTC (rev 3778)
+++ index	2009-09-09 10:16:14 UTC (rev 3779)
@@ -17322,7 +17322,8 @@
    <code><a href=#the-ins-element>ins</a></code> element in this example thus crosses a paragraph
    boundary, which is considered poor form.</p>
 
-   <pre><aside>
+   <pre class=bad><aside>
+ <!-- don't do this -->
  <ins datetime="2005-03-16T00:00Z">
   <p> I like fruit. </p>
   Apples are <em>tasty</em>.
@@ -17430,6 +17431,8 @@
 
   <h4 id=edits-and-paragraphs><span class=secno>4.7.4 </span>Edits and paragraphs</h4>
 
+  <p><i>This section is non-normative.</i></p>
+
   <p>Since the <code><a href=#the-ins-element>ins</a></code> and <code><a href=#the-del-element>del</a></code> elements do not
   affect <a href=#paragraph title=paragraph>paragraphing</a>, it is possible,
   in some cases where paragraphs are <a href=#paragraph title=paragraph>implied</a> (without explicit <code><a href=#the-p-element>p</a></code>
@@ -17456,12 +17459,13 @@
   <code><a href=#the-ins-element>ins</a></code> or <code><a href=#the-del-element>del</a></code> element (though this is very
   confusing, and not considered good practice):</p>
 
-  <pre><section>
+  <pre class=bad><section>
  This is the first paragraph. <ins>This sentence was
  inserted.
  <p>This second paragraph was inserted.</p>
  This sentence was inserted too.</ins> This is the
  third paragraph in this example.
+ <!-- (don't do this) -->
 </section></pre>
 
   <p>However, due to the way <a href=#paragraph title=paragraph>implied
@@ -17481,13 +17485,16 @@
 </section></pre>
 
   <p>Partly because of the confusion described above, authors are
-  strongly recommended to always mark up all paragraphs with the
-  <code><a href=#the-p-element>p</a></code> element, and to not have any <code><a href=#the-ins-element>ins</a></code> or
-  <code><a href=#the-del-element>del</a></code> elements that cross across any <a href=#paragraph title=paragraph>implied paragraphs</a>.</p>
+  strongly encouraged to always mark up all paragraphs with the
+  <code><a href=#the-p-element>p</a></code> element, instead of having <code><a href=#the-ins-element>ins</a></code> or
+  <code><a href=#the-del-element>del</a></code> elements that cross <a href=#paragraph title=paragraph>implied
+  paragraphs</a> boundaries.</p>
 
 
   <h4 id=edits-and-lists><span class=secno>4.7.5 </span>Edits and lists</h4>
 
+  <p><i>This section is non-normative.</i></p>
+
   <p>The content models of the <code><a href=#the-ol-element>ol</a></code> and <code><a href=#the-ul-element>ul</a></code>
   elements do not allow <code><a href=#the-ins-element>ins</a></code> and <code><a href=#the-del-element>del</a></code> elements
   as children. Lists always represent all their items, including items

Modified: source
===================================================================
--- source	2009-09-09 09:59:29 UTC (rev 3778)
+++ source	2009-09-09 10:16:14 UTC (rev 3779)
@@ -18602,7 +18602,8 @@
    <code>ins</code> element in this example thus crosses a paragraph
    boundary, which is considered poor form.</p>
 
-   <pre><aside>
+   <pre class="bad"><aside>
+ <!-- don't do this -->
  <ins datetime="2005-03-16T00:00Z">
   <p> I like fruit. </p>
   Apples are <em>tasty</em>.
@@ -18719,6 +18720,8 @@
 
   <h4>Edits and paragraphs</h4>
 
+  <p><i>This section is non-normative.</i></p>
+
   <p>Since the <code>ins</code> and <code>del</code> elements do not
   affect <span title="paragraph">paragraphing</span>, it is possible,
   in some cases where paragraphs are <span
@@ -18746,12 +18749,13 @@
   <code>ins</code> or <code>del</code> element (though this is very
   confusing, and not considered good practice):</p>
 
-  <pre><section>
+  <pre class="bad"><section>
  This is the first paragraph. <ins>This sentence was
  inserted.
  <p>This second paragraph was inserted.</p>
  This sentence was inserted too.</ins> This is the
  third paragraph in this example.
+ <!-- (don't do this) -->
 </section></pre>
 
   <p>However, due to the way <span title="paragraph">implied
@@ -18771,14 +18775,16 @@
 </section></pre>
 
   <p>Partly because of the confusion described above, authors are
-  strongly recommended to always mark up all paragraphs with the
-  <code>p</code> element, and to not have any <code>ins</code> or
-  <code>del</code> elements that cross across any <span
-  title="paragraph">implied paragraphs</span>.</p>
+  strongly encouraged to always mark up all paragraphs with the
+  <code>p</code> element, instead of having <code>ins</code> or
+  <code>del</code> elements that cross <span title="paragraph">implied
+  paragraphs</span> boundaries.</p>
 
 
   <h4>Edits and lists</h4>
 
+  <p><i>This section is non-normative.</i></p>
+
   <p>The content models of the <code>ol</code> and <code>ul</code>
   elements do not allow <code>ins</code> and <code>del</code> elements
   as children. Lists always represent all their items, including items