Merge pull request #2504 from w3c/htmlaam-571

Fix incorrect role specified for html element - 571

Author: scottaohara

html-aam/index.html

@@ -2977,7 +2977,7 @@ <h4 id="el-html">`html`</h4>
             </tr>
             <tr>
               <th>[[wai-aria-1.2]]</th>
-              <td><a class="core-mapping" href="#role-map-document">`document`</a> role</td>
+              <td><a class="core-mapping" href="#role-map-generic">`generic`</a> role</td>
             </tr>
             <tr>
               <th><a data-cite="core-aam-1.2/#roleMappingComputedRole">Computed Role</a></th>
@@ -3012,7 +3012,10 @@ <h4 id="el-html">`html`</h4>
             <!-- <th><a href="#accessible-name-and-description-computation">Naming Algorithm</a></th> -->
             <tr>
               <th>Comments</th>
-              <td>User agents MUST ignore the `aria-hidden` attribute if specified on the `html` element.</td>
+              <td>
+                <p>User agents MUST ignore the `aria-hidden` attribute if specified on the `html` element.</p>
+                <p class="note">The `document` role of a web page is not exposed by the `html` element, but rather from a parent `document node` created by the user agent.</p>
+              </td>
             </tr>
           </tbody>
         </table>

index.html

@@ -14020,9 +14020,9 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
               <code>aria-hidden</code> attribute value set to <code>true</code>.
             </p>
             <p>
-              Authors MUST NOT use <code>aria-hidden</code> to hide the root element or the host language element that <a data-cite="html/dom.html#represents">represents</a> the contents of the
-              primary document in view. For instance, the <code>html</code> or <code>body</code> elements in an HTML document. Authors MAY, with caution, use <code>aria-hidden</code> to hide visibly
-              rendered content from assistive technologies <em>only</em> if the act of hiding this content is intended to improve the experience for users of assistive technologies by removing
+              Authors MUST NOT use <code>aria-hidden</code> to hide the root element or the host language element that <a data-cite="html/dom.html#represents">represents</a> or contains the contents
+              of the primary document in view. For instance, the <code>html</code> or <code>body</code> elements in an HTML document. Authors MAY, with caution, use <code>aria-hidden</code> to hide
+              visibly rendered content from assistive technologies <em>only</em> if the act of hiding this content is intended to improve the experience for users of assistive technologies by removing
               redundant or extraneous content. Authors using <code>aria-hidden</code> to hide visible content from screen readers MUST ensure that identical or equivalent meaning and functionality is
               exposed to assistive technologies.
             </p>
@@ -14042,10 +14042,10 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
             </p>
             <p>
               To prevent authors erroneously hiding entire window-rendered documents only to those using assistive technology, user agents MUST NOT expose the hidden state to assistive technologies if
-              it is specified on the root element or the host language element that <a data-cite="html/dom.html#represents">represents</a> the contents of the primary document in view. For instance,
-              the <code>html</code> or <code>body</code> elements in an HTML document, or the root <code>svg</code> element if it is rendered as its own primary document in the browser window. If
-              authors were to specify <code>aria-hidden="true"</code> on the opening tag for an embedded document, for instance on a <code>math</code> or <code>svg</code> embedded within an HTML
-              document, user agents would still be expected to hide these elements from assistive technologies.
+              it is specified on the root element or the host language element that <a data-cite="html/dom.html#represents">represents</a> or contains the contents of the primary document in view. For
+              instance, the <code>html</code> or <code>body</code> elements in an HTML document, or the root <code>svg</code> element if it is rendered as its own primary document in the browser
+              window. If authors were to specify <code>aria-hidden="true"</code> on the opening tag for an embedded document, for instance on a <code>math</code> or <code>svg</code> embedded within an
+              HTML document, user agents would still be expected to hide these elements from assistive technologies.
             </p>
           </div>
           <table class="def">