html-author/Overview.html 1.27 Updated issue note about HTML Vocabulary

Updated issue note about HTML Vocabulary changes

4 The HTML Vocabulary and APIs
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.27.html#the-html-vocabulary-and-apis
1 Introduction
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.27.html#introduction
4.1 The html element
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.27.html#the-html-element
3.1 HTML
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.27.html#html

http://people.w3.org/mike/diffs/html5/html-author/Overview.diff.html
http://dev.w3.org/cvsweb/html5/html-author/Overview.html?r1=1.26&r2=1.27&f=h

===================================================================
RCS file: /sources/public/html5/html-author/Overview.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -d -r1.26 -r1.27
--- Overview.html 1 Feb 2009 21:49:04 -0000 1.26
+++ Overview.html 1 Feb 2009 21:52:11 -0000 1.27
@@ -396,10 +396,15 @@
 
 <section>
  <h2 id=the-html-vocabulary-and-apis><span class=secno>4 </span>The HTML Vocabulary and APIs</h2>
- <p class=big-issue>Each of these needs longer descriptions and the elements
-    should be divided into categories. The script that generates these
-    doesn't yet include brief descriptions of elements and the start/end tag
-    requirement info. Expect major changes to this section.</p>
+ <p class=big-issue>Expect major changes to this section. Each of these
+    needs longer descriptions and the elements should be divided into
+    categories. The script that generates these doesn't yet include brief
+    descriptions of elements and the start/end tag requirement info.
+    The IDL for the DOM Interfaces is likely to be replaced by something
+    a lot more reader-friendly in the future; consider it a placeholder
+    for now. Attributes will likely be accompanied by brief descriptions
+    within the summary box, in addition to fuller descriptions and examples
+    afterwards.</p>
  <div class=element>
   <h3 id=the-html-element><span class=secno>4.1 </span>The <dfn><code>html</code></dfn> element</h3>
   <div class=summary>

Index: Overview.src.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.src.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- Overview.src.html 1 Feb 2009 21:49:04 -0000 1.27
+++ Overview.src.html 1 Feb 2009 21:52:12 -0000 1.28
@@ -275,10 +275,15 @@
 
 <section>
  <h1>The HTML Vocabulary and APIs</h1>
- <p class="big-issue">Each of these needs longer descriptions and the elements
-    should be divided into categories. The script that generates these
-    doesn't yet include brief descriptions of elements and the start/end tag
-    requirement info. Expect major changes to this section.</p>
+ <p class="big-issue">Expect major changes to this section. Each of these
+    needs longer descriptions and the elements should be divided into
+    categories. The script that generates these doesn't yet include brief
+    descriptions of elements and the start/end tag requirement info.
+    The IDL for the DOM Interfaces is likely to be replaced by something
+    a lot more reader-friendly in the future; consider it a placeholder
+    for now. Attributes will likely be accompanied by brief descriptions
+    within the summary box, in addition to fuller descriptions and examples
+    afterwards.</p>
  <div class=element>
   <h2>The <dfn><code>html</code></dfn> element</h2>
   <div class=summary>

Received on Sunday, 1 February 2009 21:54:03 UTC