Merge branch 'main' into rfc2119-warnings

Author: daniel-montalvo

core-aam/index.html

@@ -56,7 +56,7 @@
             name: "Cynthia Shelly",
             company: "W3C Invited Expert",
             mailto: "buphie@gmail.com",
-            w3cid: 11897
+            w3cid: 11897,
           },
         ],
         formerEditors: [
@@ -196,6 +196,10 @@
           >comment archive</a
         >). In-progress updates to the document may be viewed in the <a href="http://w3c.github.io/core-aam/">publicly visible editors' draft</a>.
       </p>
+      <p>
+        <strong>Living specification</strong> &mdash; This document is maintained as a living specification. For the latest normative version, visit
+        <a href="https://www.w3.org/TR/core-aam-1.2/">Core Accessibility API Mappings</a>.
+      </p>
     </section>
     <section id="intro" class="informative">
       <h2>Introduction</h2>
@@ -212,8 +216,8 @@ <h2>Introduction</h2>
         <li>
           <cite
             ><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Authoring Practices Guide</a></cite
-          >, describes how web content developers can develop accessible rich internet applications using <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>.
-          It provides detailed advice and examples directed primarily to web application developers, yet also useful to user agent and developers of assistive technologies.
+          >, describes how web content developers can develop accessible rich internet applications using <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>. It provides detailed
+          advice and examples directed primarily to web application developers, yet also useful to user agent and developers of assistive technologies.
         </li>
         <li>
           <cite
@@ -358,9 +362,7 @@ <h5>Accessible Names and Descriptions</h5>
       </section>
     </section>
     <section id="conformance">
-      <p>
-        Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.
-      </p>
+      <p>Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.</p>
       <p>
         Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow
         such recommendations in order to conform to this specification.
@@ -544,15 +546,17 @@ <h2>Computed Role</h2>
           <p class="note">
             When an element has a role but is not contained in the required context (for example, an orphaned `listitem` without the required accessible parent of role `list`), this is an authoring
             error, but the user agent behavior is not specified as a single rule. For most roles, user agents can either recover the error by ignoring the role, or respect the author's intended role
-            in scenarios deemed by the implementation to be harmless. Please note that this permissiveness in how engines treat author role errors might be overridden in a language-specific mapping document such as [[HTML-AAM]].
+            in scenarios deemed by the implementation to be harmless. Please note that this permissiveness in how engines treat author role errors might be overridden in a language-specific mapping
+            document such as [[HTML-AAM]].
           </p>
           <aside class="example">
             <!-- ReSpec needs these examples to be unindented. -->
             <pre>
 &lt;div role="listitem"&gt; &lt;!-- Author error: orphaned listitem. computedrole is unspecified. --&gt;
 
 &lt;div role="list"&gt; &lt;!-- computedrole returns "list" --&gt;
-  &lt;div role="listitem"&gt; &lt;!-- computedrole returns "listitem" in the appropriate context. --&gt;</pre>
+  &lt;div role="listitem"&gt; &lt;!-- computedrole returns "listitem" in the appropriate context. --&gt;</pre
+            >
           </aside>
           <p>
             When host language elements do not have an exact or equivalent mapping to a valid, non-abstract role, the related Accessibilty API Mapping extension specification MAY specify a unique
@@ -10755,7 +10759,12 @@ <h3>Changes to document content or node visibility</h3>
               </tr>
             </tbody>
           </table>
-          <p>Fire the following events for node changes where the node in question is an element and has an <a class="termref">accessible object</a>. The <dfn data-export="" data-lt="accessibility subtree">accessibility subtree</dfn> of a node is its <a class="termref">accessible object</a> in the <a>accessibility tree</a> and all of it's <a>accessibility descendants</a>. It does not include objects which have relationships other than parent-child in that tree. For example, it does not include objects linked via <a class="specref" href="#aria-flowto">aria-flowto</a> unless those objects are also descendants in the <a>accessibility tree</a>.
+          <p>
+            Fire the following events for node changes where the node in question is an element and has an <a class="termref">accessible object</a>. The
+            <dfn data-export="" data-lt="accessibility subtree">accessibility subtree</dfn> of a node is its <a class="termref">accessible object</a> in the <a>accessibility tree</a> and all of it's
+            <a>accessibility descendants</a>. It does not include objects which have relationships other than parent-child in that tree. For example, it does not include objects linked via
+            <a class="specref" href="#aria-flowto">aria-flowto</a> unless those objects are also descendants in the <a>accessibility tree</a>.
+          </p>
           <table class="data">
             <caption>
               Table of document change scenarios and events to be fired in each

dpub-aam/index.html

@@ -164,6 +164,10 @@
     </section>
     <section id="sotd">
       <p>Future updates to this specification may incorporate <a href="https://www.w3.org/policies/process/20231103/#allow-new-features">new features</a>.</p>
+      <p>
+        <strong>Living specification</strong> &mdash; This document is maintained as a living specification. For the latest normative version, visit
+        <a href="https://www.w3.org/TR/dpub-aam/">Digital Publishing Accessibility API Mappings</a>.
+      </p>
     </section>
     <section id="intro" class="informative">
       <h2>Introduction</h2>
@@ -181,9 +185,7 @@ <h2>Introduction</h2>
       </p>
     </section>
     <section id="conformance" class="normative">
-      <p>
-        Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.
-      </p>
+      <p>Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.</p>
       <p>
         Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow
         such recommendations in order to conform to this specification.

index.html

@@ -238,7 +238,7 @@ <h1>Introduction</h1>
         <cite
           ><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
         >
-       for the use of roles in making interactive content accessible.
+        for the use of roles in making interactive content accessible.
       </p>
       <p>
         Roles defined by this specification are designed to support the roles used by platform <a>accessibility <abbr title="Application Programming Interfaces">APIs</abbr></a
@@ -376,9 +376,12 @@ <h2>Target Audience</h2>
           following documents provide important supporting information:
         </p>
         <ul>
-          <li><cite><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr>
-    Authoring Practices Guide</a></cite>
-addresses authoring recommendations for HTML, and is also of interest to developers of authoring tools and conformance checkers.</li>
+          <li>
+            <cite
+              ><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
+            >
+            addresses authoring recommendations for HTML, and is also of interest to developers of authoring tools and conformance checkers.
+          </li>
           <li>[[[CORE-AAM-1.2]]] addresses developers of [=user agents=] and <a class="termref">assistive technologies</a>.</li>
           <li>[[[ACCNAME-1.2]]] also addresses developers of [=user agents=] and <a class="termref">assistive technologies</a>.</li>
         </ul>
@@ -769,13 +772,11 @@ <h1>Important Terms</h1>
     </section>
     <section class="normative" id="conformance">
       <p>
-        The main content of this specification is "normative" and defines requirements that impact conformance claims. Introductory material, appendices, sections marked as "non-normative" and
-        their subsections, diagrams, examples, and notes are "informative" (non-normative). Non-normative material provides advisory information to help interpret the guidelines but does not
-        create requirements that impact a conformance claim.
-      </p>
-      <p>
-        Normative sections provide requirements that authors, user agents and assistive technologies MUST follow for an implementation to conform to this specification.
+        The main content of this specification is "normative" and defines requirements that impact conformance claims. Introductory material, appendices, sections marked as "non-normative" and their
+        subsections, diagrams, examples, and notes are "informative" (non-normative). Non-normative material provides advisory information to help interpret the guidelines but does not create
+        requirements that impact a conformance claim.
       </p>
+      <p>Normative sections provide requirements that authors, user agents and assistive technologies MUST follow for an implementation to conform to this specification.</p>
       <p>
         Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow
         such recommendations in order to conform to this specification.
@@ -10448,7 +10449,7 @@ <h5>Presentational Role Inheritance</h5>
             <p>
               <rref>tablist</rref> elements are typically placed near, and usually preceding, a series of <rref>tabpanel</rref> elements. See the
               <cite
-                ><a href="https://www.w3.org/WAI/ARIA/apg/""><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
+                ><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
               >
               for details on implementing a tab set design pattern.
             </p>