html5/html-author Overview.html,1.26,1.27 Overview.src.html,1.27,1.28

Update of /sources/public/html5/html-author
In directory hutz:/tmp/cvs-serv16638

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Updated issue note about HTML Vocabulary changes

Index: Overview.html
===================================================================
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:52:23 UTC