[html5] r4019 - [a] (0) Recommend just redesigning tables to not need explanations instead of in [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2009-09-28 18:22:27 -0700 (Mon, 28 Sep 2009)
New Revision: 4019

Modified:
   index
   source
Log:
[a] (0) Recommend just redesigning tables to not need explanations instead of including complicated descriptions.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7635

Modified: index
===================================================================
--- index	2009-09-29 01:13:49 UTC (rev 4018)
+++ index	2009-09-29 01:22:27 UTC (rev 4019)
@@ -27959,8 +27959,8 @@
      <tr><td headers="n r2"> Failing
       <th id=r2> Grade
       <td> Passing
-   </table><p>...might benefit from a description explaining to the way the
-   table is laid out, something like "Characteristics are given in the
+   </table><p>...might benefit from a description explaining the way the table
+   is laid out, something like "Characteristics are given in the
    second column, with the negative side in the left column and the
    positive side in the right column".</p>
 
@@ -28117,6 +28117,37 @@
   </dl><p>Authors may also use other techniques, or combinations of the
   above techniques, as appropriate.</p>
 
+  <p>The best option, of course, rather than writing a description
+  explaining the way the table is laid out, is to adjust the table
+  such that no explanation is needed.</p>
+
+  <div class=example>
+
+   <p>In the case of the table used in the examples above, a simple
+   rearrangement of the table so that the headers are on the top and
+   left sides removes the need for an explanation as well as removing
+   the need for the use of <code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code> attributes:</p>
+
+   <pre><table>
+ <caption>Characteristics with positive and negative sides</caption>
+ <thead>
+  <tr>
+   <th> Characteristic
+   <th> Negative
+   <th> Positive
+ <tbody>
+  <tr>
+   <th> Mood
+   <td> Sad
+   <td> Happy
+  <tr>
+   <th> Grade
+   <td> Failing
+   <td> Passing
+</table></pre>
+
+  </div>
+
   <p>The <dfn id=attr-table-summary title=attr-table-summary><code>summary</code></dfn>
   attribute on <code><a href=#the-table-element>table</a></code> elements was suggested in earlier
   versions of the language as a technique for providing explanatory

Modified: source
===================================================================
--- source	2009-09-29 01:13:49 UTC (rev 4018)
+++ source	2009-09-29 01:22:27 UTC (rev 4019)
@@ -30803,8 +30803,8 @@
       <td> Passing
    </table>
 
-   <p>...might benefit from a description explaining to the way the
-   table is laid out, something like "Characteristics are given in the
+   <p>...might benefit from a description explaining the way the table
+   is laid out, something like "Characteristics are given in the
    second column, with the negative side in the left column and the
    positive side in the right column".</p>
 
@@ -30965,6 +30965,38 @@
   <p>Authors may also use other techniques, or combinations of the
   above techniques, as appropriate.</p>
 
+  <p>The best option, of course, rather than writing a description
+  explaining the way the table is laid out, is to adjust the table
+  such that no explanation is needed.</p>
+
+  <div class="example">
+
+   <p>In the case of the table used in the examples above, a simple
+   rearrangement of the table so that the headers are on the top and
+   left sides removes the need for an explanation as well as removing
+   the need for the use of <code
+   title="attr-tdth-headers">headers</code> attributes:</p>
+
+   <pre><table>
+ <caption>Characteristics with positive and negative sides</caption>
+ <thead>
+  <tr>
+   <th> Characteristic
+   <th> Negative
+   <th> Positive
+ <tbody>
+  <tr>
+   <th> Mood
+   <td> Sad
+   <td> Happy
+  <tr>
+   <th> Grade
+   <td> Failing
+   <td> Passing
+</table></pre>
+
+  </div>
+
   <p>The <dfn title="attr-table-summary"><code>summary</code></dfn>
   attribute on <code>table</code> elements was suggested in earlier
   versions of the language as a technique for providing explanatory