html5/spec-author-view Overview.html,1.784,1.785 semantics.html,1.578,1.579 spec.html,1.790,1.791

Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv6258

Modified Files:
	Overview.html semantics.html spec.html 
Log Message:
Fix the text added for ISSUE-79 to use appropriate terminology and to fit the style of the specification. (whatwg r4861)

[updated by splitter]


Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/Overview.html,v
retrieving revision 1.784
retrieving revision 1.785
diff -u -d -r1.784 -r1.785
--- Overview.html	23 Mar 2010 07:17:43 -0000	1.784
+++ Overview.html	23 Mar 2010 08:57:00 -0000	1.785
@@ -306,7 +306,7 @@
    </dl><p>This specification is available in the following formats: 
     <a href="spec.html">single page HTML</a>,
     <a href="Overview.html">multipage HTML</a>.
-This is revision 1.3893.
+This is revision 1.3894.
    </p> 
    <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2010 <a href="http://www.w3.org/"><abbr title="World Wide

Index: semantics.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/semantics.html,v
retrieving revision 1.578
retrieving revision 1.579
diff -u -d -r1.578 -r1.579
--- semantics.html	23 Mar 2010 07:17:43 -0000	1.578
+++ semantics.html	23 Mar 2010 08:57:00 -0000	1.579
@@ -718,20 +718,32 @@
 
    <dd>
 
-    <p>Contains a comma-separated list of keywords relevant to the page.</p>
+    <p>The value must be a <a href="common-microsyntaxes.html#set-of-comma-separated-tokens">set of comma-separated tokens</a>,
+    each of which is a keyword relevant to the page.</p>
 
-    <p>Note that many search engines have stopped to consider keyword
-    information as relevant because it has been used unreliably or even
-    misleading. Recipients are recommended to use this information only
-    when there's sufficient confidence in the reliability of this
-    information, for instance in controlled environments such as sites
-    generated from a content management system.</p>
+    <div class="example">
 
-    <p class="XXX">The text above is not in the right form for the
-    spec (no conformance criteria, the note uses the wrong writing
-    style, no examples, uses the wrong terminology for consistency
-    with this spec, etc), but is what the working group agreed. It
-    will be fixed momentarily.</p>
+     <p>This page about typefaces on British motorways uses a
+     <code><a href="#meta">meta</a></code> element to specify some keywords that users
+     might use to look for the page:</p>
+
+     <pre>&lt;!DOCTYPE HTML&gt;
+&lt;html&gt;
+ &lt;head&gt;
+  &lt;title&gt;Typefaces on UK motorways&lt;/title&gt;
+  &lt;meta name="keywords" content="british,type face,font,fonts,highway,highways"&gt;
+ &lt;/head&gt;
+ &lt;body&gt;
+  ...</pre>
+
+    </div>
+
+    <p class="note">Many search engines do not consider such keywords,
+    because this feature has historically been used unreliably and
+    even misleadingly as a way to spam search engine results in a way
+    that is not helpful for users.</p>
+
+    
 
    </dd>
 

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.html,v
retrieving revision 1.790
retrieving revision 1.791
diff -u -d -r1.790 -r1.791
--- spec.html	23 Mar 2010 07:17:43 -0000	1.790
+++ spec.html	23 Mar 2010 08:57:00 -0000	1.791
@@ -304,7 +304,7 @@
    </dl><p>This specification is available in the following formats: 
     <a href=spec.html>single page HTML</a>,
     <a href=Overview.html>multipage HTML</a>.
-This is revision 1.3893.
+This is revision 1.3894.
    </p> 
    <p class=copyright><a href=http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>Copyright</a>
    © 2010 <a href=http://www.w3.org/><abbr title="World Wide
@@ -4508,20 +4508,32 @@
 
    <dd>
 
-    <p>Contains a comma-separated list of keywords relevant to the page.</p>
+    <p>The value must be a <a href=#set-of-comma-separated-tokens>set of comma-separated tokens</a>,
+    each of which is a keyword relevant to the page.</p>
 
-    <p>Note that many search engines have stopped to consider keyword
-    information as relevant because it has been used unreliably or even
-    misleading. Recipients are recommended to use this information only
-    when there's sufficient confidence in the reliability of this
-    information, for instance in controlled environments such as sites
-    generated from a content management system.</p>
+    <div class=example>
 
-    <p class=XXX>The text above is not in the right form for the
-    spec (no conformance criteria, the note uses the wrong writing
-    style, no examples, uses the wrong terminology for consistency
-    with this spec, etc), but is what the working group agreed. It
-    will be fixed momentarily.</p>
+     <p>This page about typefaces on British motorways uses a
+     <code><a href=#meta>meta</a></code> element to specify some keywords that users
+     might use to look for the page:</p>
+
+     <pre>&lt;!DOCTYPE HTML&gt;
+&lt;html&gt;
+ &lt;head&gt;
+  &lt;title&gt;Typefaces on UK motorways&lt;/title&gt;
+  &lt;meta name="keywords" content="british,type face,font,fonts,highway,highways"&gt;
+ &lt;/head&gt;
+ &lt;body&gt;
+  ...</pre>
+
+    </div>
+
+    <p class=note>Many search engines do not consider such keywords,
+    because this feature has historically been used unreliably and
+    even misleadingly as a way to spam search engine results in a way
+    that is not helpful for users.</p>
+
+    
 
    </dd>
 

Received on Tuesday, 23 March 2010 08:57:05 UTC