From 37ec3a91827f2aab63b4ca04734e220071f7e628 Mon Sep 17 00:00:00 2001
From: Matt King <a11yThinker@Gmail.com>
Date: Sat, 13 Jul 2019 00:29:49 -0700
Subject: [PATCH] Accessible Name Guidance by Role Table: Advise that empty
 cells are represented by empty names (pull #1081)

* Add note to cell and gridcell guidance explaining that an empty name represents and empty cell.
* Add thead and tbody elements to name guidance by role table.
---
 aria-practices.html | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/aria-practices.html b/aria-practices.html
index ba4e2fb746..ea3b6b9728 100644
--- a/aria-practices.html
+++ b/aria-practices.html
@@ -4189,12 +4189,15 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
           </dd>
         </dl>
         <table aria-labelledby="naming_role_guidance_heading">
-          <tr>
-            <th>role</th>
-            <th>Necessity of Naming</th>
-            <th>Guidance</th>
-          </tr>
-          <tr>
+          <thead>
+            <tr>
+              <th>role</th>
+              <th>Necessity of Naming</th>
+              <th>Guidance</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
               <td><a href="#alert" class="role-reference"><code>alert</code></a></td>
               <td>Discretionary</td>
               <td>
@@ -4251,7 +4254,8 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
                 <ul>
                   <li>Warning! Using <code>aria-label</code> or <code>aria-labelledby</code> will hide descendant content from assistive technologies.</li>
                   <li>Ideally named by visible, descendant content.</li>
-                  <li>Note that associated row or column headers do not name a cell; a cell's name is its content. Headers are complementary information.</li>
+                  <li>Note that a name is not required; assistive technologies expect an empty cell in a table to be represented by an empty name.</li>
+                  <li>Note that associated row or column headers do not name a <code>cell</code>; the name of a cell in a table is its content. Headers are complementary information.</li>
                 </ul>
               </td>
             </tr>
@@ -4389,7 +4393,8 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
                 <ul>
                   <li>Warning! Using <code>aria-label</code> or <code>aria-labelledby</code> will hide descendant content from assistive technologies.</li>
                   <li>Ideally named by visible, descendant content.</li>
-                  <li>Note that associated row or column headers do not name a cell; a cell's name is its content. Headers are complementary information.</li>
+                  <li>Note that a name is not required; assistive technologies expect an empty cell in a grid to be represented by an empty name.</li>
+                  <li>Note that associated row or column headers do not name a <code>gridcell</code>; the name of a cell in a grid is its content. Headers are complementary information.</li>
                 </ul>
               </td>
             </tr>
@@ -4872,6 +4877,7 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
                 </ul>
               </td>
             </tr>
+          </tbody>
         </table>
       </section>