Skip to content

Commit

Permalink
[act] (0) Fix the text added for ISSUE-79 to use appropriate terminol…
Browse files Browse the repository at this point in the history
…ogy and to fit the style of the specification.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7525

git-svn-id: http://svn.whatwg.org/webapps@4861 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Mar 23, 2010
1 parent 26b3a9f commit 9ad9510
Show file tree
Hide file tree
Showing 3 changed files with 213 additions and 42 deletions.
81 changes: 67 additions & 14 deletions complete.html
Original file line number Diff line number Diff line change
Expand Up @@ -11531,20 +11531,73 @@ <h5 id=standard-metadata-names><span class=secno>4.2.5.1 </span>Standard metadat

<dd>

<p>Contains a comma-separated list of keywords 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>

<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>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>

<div class=example>

<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>

<div class=impl>

<p>To obtain the list of keywords that the author has specified as
applicable to the page, the user agent must run the following
steps:</p>

<ol><li><p>Let <var title="">keywords</var> be an empty
list.</li>

<li>

<p>For each <code><a href=#meta>meta</a></code> element with a <code title=attr-meta-name><a href=#attr-meta-name>name</a></code> attribute and a <code title=attr-meta-content><a href=#attr-meta-content>content</a></code> attribute and whose
<code title=attr-meta-name><a href=#attr-meta-name>name</a></code> attribute's value is
<code title=meta-keywords><a href=#meta-keywords>keywords</a></code>, run the following
substeps:</p>

<ol><li><p><a href=#split-a-string-on-commas title="split a string on commas">Split the value
of the element's <code title=attr-meta-content>content</code>
attribute on commas</a>.</li>

<li><p>Add the resulting tokens, if any, to <var title="">keywords</var>.</li>

</ol></li>

<li><p>Remove any duplicates from <var title="">keywords</var>.</li>

<li><p>Return <var title="">keywords</var>. This is the list of
keywords that the author has specified as applicable to the
page.</li>

</ol><p>User agents should not use this information when there is
insufficient confidence in the reliability of the value.</p>

<p class=example>For instance, it would be reasonable for a
content management system to use the keyword information of pages
within the system to populate the index of a site-specific search
engine, but a large-scale content aggregator that used this
information would likely find that certain users would try to game
its ranking mechanism through the use of inappropriate
keywords.</p>

</div>

</dd>

Expand Down
81 changes: 67 additions & 14 deletions index
Original file line number Diff line number Diff line change
Expand Up @@ -11430,20 +11430,73 @@ gave me some of the songs they wrote. I love sharing my music.&lt;/p&gt;

<dd>

<p>Contains a comma-separated list of keywords 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>

<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>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>

<div class=example>

<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>

<div class=impl>

<p>To obtain the list of keywords that the author has specified as
applicable to the page, the user agent must run the following
steps:</p>

<ol><li><p>Let <var title="">keywords</var> be an empty
list.</li>

<li>

<p>For each <code><a href=#meta>meta</a></code> element with a <code title=attr-meta-name><a href=#attr-meta-name>name</a></code> attribute and a <code title=attr-meta-content><a href=#attr-meta-content>content</a></code> attribute and whose
<code title=attr-meta-name><a href=#attr-meta-name>name</a></code> attribute's value is
<code title=meta-keywords><a href=#meta-keywords>keywords</a></code>, run the following
substeps:</p>

<ol><li><p><a href=#split-a-string-on-commas title="split a string on commas">Split the value
of the element's <code title=attr-meta-content>content</code>
attribute on commas</a>.</li>

<li><p>Add the resulting tokens, if any, to <var title="">keywords</var>.</li>

</ol></li>

<li><p>Remove any duplicates from <var title="">keywords</var>.</li>

<li><p>Return <var title="">keywords</var>. This is the list of
keywords that the author has specified as applicable to the
page.</li>

</ol><p>User agents should not use this information when there is
insufficient confidence in the reliability of the value.</p>

<p class=example>For instance, it would be reasonable for a
content management system to use the keyword information of pages
within the system to populate the index of a site-specific search
engine, but a large-scale content aggregator that used this
information would likely find that certain users would try to game
its ranking mechanism through the use of inappropriate
keywords.</p>

</div>

</dd>

Expand Down
93 changes: 79 additions & 14 deletions source
Original file line number Diff line number Diff line change
Expand Up @@ -11975,20 +11975,85 @@ gave me some of the songs they wrote. I love sharing my music.&lt;/p>

<dd>

<p>Contains a comma-separated list of keywords 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>

<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>The value must be a <span>set of comma-separated tokens</span>,
each of which is a keyword relevant to the page.</p>

<div class="example">

<p>This page about typefaces on British motorways uses a
<code>meta</code> element to specify some keywords that users
might use to look for the page:</p>

<pre>&lt;!DOCTYPE HTML>
&lt;html>
&lt;head>
&lt;title>Typefaces on UK motorways&lt;/title>
&lt;meta name="keywords" content="british,type face,font,fonts,highway,highways">
&lt;/head>
&lt;body>
...</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>

<div class="impl">

<p>To obtain the list of keywords that the author has specified as
applicable to the page, the user agent must run the following
steps:</p>

<ol>

<li><p>Let <var title="">keywords</var> be an empty
list.</p></li>

<li>

<p>For each <code>meta</code> element with a <code
title="attr-meta-name">name</code> attribute and a <code
title="attr-meta-content">content</code> attribute and whose
<code title="attr-meta-name">name</code> attribute's value is
<code title="meta-keywords">keywords</code>, run the following
substeps:</p>

<ol>

<li><p><span title="split a string on commas">Split the value
of the element's <code title="attr-meta-content">content</code>
attribute on commas</span>.</p></li>

<li><p>Add the resulting tokens, if any, to <var
title="">keywords</var>.</p></li>

</ol>

</li>

<li><p>Remove any duplicates from <var
title="">keywords</var>.</p></li>

<li><p>Return <var title="">keywords</var>. This is the list of
keywords that the author has specified as applicable to the
page.</p></li>

</ol>

<p>User agents should not use this information when there is
insufficient confidence in the reliability of the value.</p>

<p class="example">For instance, it would be reasonable for a
content management system to use the keyword information of pages
within the system to populate the index of a site-specific search
engine, but a large-scale content aggregator that used this
information would likely find that certain users would try to game
its ranking mechanism through the use of inappropriate
keywords.</p>

</div>

</dd>

Expand Down

0 comments on commit 9ad9510

Please sign in to comment.