[html5] r3523 - [e] (0) Explain why summary= is discouraged now.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-08-01 19:35:09 -0700 (Sat, 01 Aug 2009)
New Revision: 3523

Modified:
   index
   source
Log:
[e] (0) Explain why summary= is discouraged now.

Modified: index
===================================================================
--- index	2009-08-02 02:09:43 UTC (rev 3522)
+++ index	2009-08-02 02:35:09 UTC (rev 3523)
@@ -70707,6 +70707,18 @@
   described in the <code><a href=#the-table-element>table</a></code> section should be used
   instead.</p>
 
+  <p class=note>Use of the <code title=attr-table-summary><a href=#attr-table-summary>summary</a></code> attribute is discouraged
+  because in practice it is poorly understood. Because the attribute
+  is not exposed in visual user agents, authors who have included it
+  have typically not been able to test it, and have therefore set the
+  attribute to values that are of no use to users of accessibility
+  tools. This has lead to accessibility tools introducing heuristics
+  to try to avoid exposing such usage of the attribute to users. Even
+  the few authors who have made the best use of the attribute have
+  often misused it, for example by including text that would in fact
+  be useful for all users, or that is redundant with other information
+  on the page separate from the table.</p>
+
   <p class=XXX>It has been suggested that the summary="" attribute
   should not be obsolete, and the working group may vote on the matter
   at some future point.</p>

Modified: source
===================================================================
--- source	2009-08-02 02:09:43 UTC (rev 3522)
+++ source	2009-08-02 02:35:09 UTC (rev 3523)
@@ -83565,6 +83565,19 @@
   described in the <code>table</code> section should be used
   instead.</p>
 
+  <p class="note">Use of the <code
+  title="attr-table-summary">summary</code> attribute is discouraged
+  because in practice it is poorly understood. Because the attribute
+  is not exposed in visual user agents, authors who have included it
+  have typically not been able to test it, and have therefore set the
+  attribute to values that are of no use to users of accessibility
+  tools. This has lead to accessibility tools introducing heuristics
+  to try to avoid exposing such usage of the attribute to users. Even
+  the few authors who have made the best use of the attribute have
+  often misused it, for example by including text that would in fact
+  be useful for all users, or that is redundant with other information
+  on the page separate from the table.</p>
+
   <p class="XXX">It has been suggested that the summary="" attribute
   should not be obsolete, and the working group may vote on the matter
   at some future point.</p>