From 5ba7cb3a0fd138b4fdaa92c1606ea81281ade601 Mon Sep 17 00:00:00 2001
From: Momdo Nakamura <xmomdo@gmail.com>
Date: Fri, 13 Sep 2024 23:20:45 +0900
Subject: [PATCH] Fix mentions to HTML to Platform Accessibility APIs
 Implementation Guide (#3995)

The [HTML to Platform Accessibility APIs Implementation
Guide](https://www.w3.org/TR/html-aapi/) says "See [HTML Accessibility
API Mappings 1.0](https://www.w3.org/TR/html-aam-1.0/) instead".

So, this PR tries to replace to HTML-AAM or remove HTML-AAPI.
---
 techniques/aria/ARIA5.html   | 3 ---
 techniques/aria/ARIA6.html   | 2 +-
 techniques/aria/ARIA8.html   | 2 +-
 techniques/aria/ARIA9.html   | 4 ++--
 techniques/failures/F65.html | 3 ---
 5 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/techniques/aria/ARIA5.html b/techniques/aria/ARIA5.html
index d79b673cde..706d9249f4 100644
--- a/techniques/aria/ARIA5.html
+++ b/techniques/aria/ARIA5.html
@@ -85,9 +85,6 @@ <h3>A slider</h3>
          <li>
                <a href="https://www.w3.org/TR/wai-aria/#states_and_properties">Accessible Rich Internet Applications (WAI-ARIA), Supported States and Properties</a>
             </li>
-         <li>
-               <a href="https://www.w3.org/TR/html-aapi/#html-element-to-accessibility-api-role-mapping-matrix">HTML to Platform Accessibility APIs Implementation Guide: HTML Element to Accessibility API Role Mapping Matrix</a>
-            </li>
          <li>
                <a href="https://www.w3.org/WAI/ARIA/apg/">WAI-ARIA Authoring Practices Guide</a>
             </li>
diff --git a/techniques/aria/ARIA6.html b/techniques/aria/ARIA6.html
index d9a17917ca..ffe7362e3b 100644
--- a/techniques/aria/ARIA6.html
+++ b/techniques/aria/ARIA6.html
@@ -64,7 +64,7 @@ <h3>Providing a label for Math</h3>
       
          <ul>
             <li>
-                  <a href="https://www.w3.org/TR/html-aapi/#html-element-to-accessibility-api-role-mapping-matrix">HTML to Platform Accessibility APIs Implementation Guide: HTML Element to Accessibility API Role Mapping Matrix</a>
+                  <a href="https://www.w3.org/TR/html-aam-1.0/">HTML Accessibility API Mappings 1.0</a>
                </li>
             <li>
                   <a href="https://www.w3.org/WAI/ARIA/apg/">WAI-ARIA Authoring Practices Guide</a> 
diff --git a/techniques/aria/ARIA8.html b/techniques/aria/ARIA8.html
index 61d4d7ef8a..d38e1967fe 100644
--- a/techniques/aria/ARIA8.html
+++ b/techniques/aria/ARIA8.html
@@ -2,7 +2,7 @@
       <p>Technologies that support <a href="https://www.w3.org/TR/wai-aria/">Accessible Rich Internet Applications (WAI-ARIA)</a>. </p>
    </section><section id="description"><h2>Description</h2>
       <p>The objective of this technique is to describe the purpose of a link using the <code class="language-html">aria-label</code> attribute. The <code class="language-html">aria-label</code> attribute provides a way to place a descriptive text label on an object, such as a link, when there are no elements visible on the page that describe the object. If descriptive elements are visible on the page, the <code class="language-html">aria-labelledby</code> attribute should be used instead of <code class="language-html">aria-label</code>. Providing a descriptive text label lets a user distinguish the link from links in the Web page that lead to other destinations and helps the user determine whether to follow the link. In some assistive technologies the <code class="language-html">aria-label</code> value will show in the list of links instead of the actual link text.</p>
-      <p>Per the <a href="https://www.w3.org/TR/accname/">Accessible Name and Description Computation</a> and the <a href="https://www.w3.org/TR/html-aapi/#accessible-name-and-description-calculation">HTML to Platform Accessibility APIs Implementation Guide</a>, the <code class="language-html">aria-label</code> text will override the text supplied within the link. As such the text supplied will be used instead of the link text by assistive technology. Due to this it is recommended to start the text used in <code class="language-html">aria-label</code> with the text used within the link. This will allow consistent communication between users.</p>
+      <p>Per the <a href="https://www.w3.org/TR/accname/">Accessible Name and Description Computation</a> and the <a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">Accessible Name and Description Computation</a> in the HTML Accessibility API Mappings 1.0, the <code class="language-html">aria-label</code> text will override the text supplied within the link. As such the text supplied will be used instead of the link text by assistive technology. Due to this it is recommended to start the text used in <code class="language-html">aria-label</code> with the text used within the link. This will allow consistent communication between users.</p>
    </section><section id="examples"><h2>Examples</h2>
       <section class="example">
          <h3>Describing the purpose of a link in HTML using aria-label.</h3>
diff --git a/techniques/aria/ARIA9.html b/techniques/aria/ARIA9.html
index 1ee130cbcb..8e4c42601f 100644
--- a/techniques/aria/ARIA9.html
+++ b/techniques/aria/ARIA9.html
@@ -7,14 +7,14 @@
       <p>The concatenation of strings can be useful for different reasons. In example 1, an input is nested within the context of a full sentence. The desired screen reader output is "Extend time-out to [ 20 ] minutes - edit with autocomplete, selected 20". Since the <code class="language-html">id</code> of the text input is included in the string of <code class="language-html">id</code>s referenced by aria-labelledby, the value of the input is included in the concatenated name at the right position.</p>
       <p>Another application of <code class="language-html">aria-labelledby</code> is when there is no space to provide a visible label next to the input, or when using native labels would create unnecessary redundancy. Here, the use <code class="language-html">aria-labelledby</code> makes it possible to associate visible elements on the page as name for such inputs. This is demonstrated in example 2 where table column and row headings are concatenated into names for the text input elements inside the table.</p>
       <div class="note">
-         <p>The <a href="https://www.w3.org/TR/html-aapi/#accessible-name-and-description-calculation">ARIA accessible name and description calculation</a> specifies that the string specified in <code class="language-html">aria-labelledby</code> should replace rather than add to the content of the element that carries the property. So adding the <code class="language-html">aria-labelledby</code> property to a native label should replace the text content inside that label unless the label itself is referenced as part of the sequence of <code class="language-html">id</code>s in <code class="language-html">aria-labelledby</code>.</p>
+         <p>The <a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">Accessible Name and Description Computation</a> specifies that the string specified in <code class="language-html">aria-labelledby</code> should replace rather than add to the content of the element that carries the property. So adding the <code class="language-html">aria-labelledby</code> property to a native label should replace the text content inside that label unless the label itself is referenced as part of the sequence of <code class="language-html">id</code>s in <code class="language-html">aria-labelledby</code>.</p>
       </div>
    </section><section id="examples"><h2>Examples</h2>
       <section class="example">
          <h3>A time-out input field with concatenated name</h3>
          
             <p>A text input allows users to extend the default time before a time-out occurs.</p>
-            <p>The string "Extend time-out to" is contained in a native <code class="language-html">label</code> element and is associated with the input with the input by id="timeout-duration" . This label is associated with this input using the for/id association only on user agents that don't support ARIA. On user agents that support ARIA, the for/id association is ignored and the name for the input is provided only by <code class="language-html">aria-labelledby</code>, per the <a href="https://www.w3.org/TR/html-aapi/#accessible-name-and-description-calculation">accessible name and description calculation</a> in the HTML to Platform Accessibility APIs Implementation Guide.</p>
+            <p>The string "Extend time-out to" is contained in a native <code class="language-html">label</code> element and is associated with the input with the input by id="timeout-duration" . This label is associated with this input using the for/id association only on user agents that don't support ARIA. On user agents that support ARIA, the for/id association is ignored and the name for the input is provided only by <code class="language-html">aria-labelledby</code>, per the <a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">Accessible Name and Description Computation</a> in the HTML Accessibility API Mappings 1.0.</p>
             <p>The <code class="language-html">aria-labelledby</code> attribute on the text input references three elements: (1) the <code class="language-html">span</code> containing the native label, (2) the text input containing the default text '20' (recall that this input is not labelled with the for/id associated label text), and (3) the string 'minutes' contained in a <code class="language-html">span</code>. These elements should be concatenated to provide the full name for the text input</p>
 <pre xml:space="preserve"><code class="language-html">&lt;div&gt;
   &lt;span id="timeout-label"&gt;
diff --git a/techniques/failures/F65.html b/techniques/failures/F65.html
index 4732d30257..1979795151 100644
--- a/techniques/failures/F65.html
+++ b/techniques/failures/F65.html
@@ -36,9 +36,6 @@ <h3>Missing text alternative</h3>
    </ul></section><section id="resources"><h2>Resources</h2>
       
          <ul>
-            <li>
-               <a href="https://www.w3.org/TR/html-aapi/#accessible-name-and-description-calculation">HTML to Platform Accessibility APIs Implementation Guide: Accessible Name and Description Calculation</a>
-            </li>
             <li>
                <a href="https://www.w3.org/TR/accname/">Accessible Name and Description Computation</a>
             </li>