hixie: Try to reduce the confusion caused by implied paragraphs and <ins>/<del>, by making some sections non-normative, and clearly marking bad examples. (whatwg r3779)

hixie: Try to reduce the confusion caused by implied paragraphs and
<ins>/<del>, by making some sections non-normative, and clearly marking
bad examples. (whatwg r3779)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2948&r2=1.2949&f=h
http://html5.org/tools/web-apps-tracker?from=3778&to=3779

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2948
retrieving revision 1.2949
diff -u -d -r1.2948 -r1.2949
--- Overview.html 9 Sep 2009 09:55:12 -0000 1.2948
+++ Overview.html 9 Sep 2009 10:11:57 -0000 1.2949
@@ -15093,7 +15093,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>&lt;aside&gt;
+   <pre class="bad">&lt;aside&gt;
+ &lt;!-- don't do this --&gt;
  &lt;ins datetime="2005-03-16T00:00Z"&gt;
   &lt;p&gt; I like fruit. &lt;/p&gt;
   Apples are &lt;em&gt;tasty&lt;/em&gt;.
@@ -15169,7 +15170,7 @@
   attribute must <a href="#reflect">reflect</a> the element's <code title="attr-mod-cite"><a href="#attr-mod-cite">cite</a></code> content attribute. The <dfn id="dom-mod-datetime" title="dom-mod-datetime"><code>dateTime</code></dfn> IDL attribute
   must <a href="#reflect">reflect</a> the element's <code title="">datetime</code> content attribute.</p>
 
-  </div><h4 id="edits-and-paragraphs"><span class="secno">4.7.4 </span>Edits and paragraphs</h4><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
+  </div><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>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>
   elements), for an <code><a href="#the-ins-element">ins</a></code> or <code><a href="#the-del-element">del</a></code> element to
@@ -15187,12 +15188,13 @@
   can even get the end of one paragraph, a whole second paragraph,
   and the start of a third paragraph to be covered by the same
   <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):<pre>&lt;section&gt;
+  confusing, and not considered good practice):<pre class="bad">&lt;section&gt;
  This is the first paragraph. &lt;ins&gt;This sentence was
  inserted.
  &lt;p&gt;This second paragraph was inserted.&lt;/p&gt;
  This sentence was inserted too.&lt;/ins&gt; This is the
  third paragraph in this example.
+ &lt;!-- (don't do this) --&gt;
 &lt;/section&gt;</pre><p>However, due to the way <a href="#paragraph" title="paragraph">implied
   paragraphs</a> are defined, it is not possible to mark up the
   end of one paragraph and the start of the very next one using the
@@ -15206,9 +15208,10 @@
  &lt;p&gt;&lt;del&gt;This sentence was deleted too.&lt;/del&gt; That
  sentence needed a separate &amp;lt;del&amp;gt; element.&lt;/p&gt;
 &lt;/section&gt;</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>.<h4 id="edits-and-lists"><span class="secno">4.7.5 </span>Edits and lists</h4><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>
+  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.<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>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
   that would otherwise have been marked as deleted.<p>To indicate that an item is inserted or deleted, an

Received on Wednesday, 9 September 2009 10:12:53 UTC