Consider accessible description in the rules that use link context (5effbb, fd3a94)

_rules/link-in-context-descriptive-5effbb.md

@@ -35,7 +35,7 @@ This rule applies to any [inheriting semantic][] `link` for which all the follow
 
 ## Expectation
 
-The [accessible name][] of each target element together with its [programmatically determined link context][] describes the purpose of the link.
+The [accessible name][] of each target element together with its [accessible description][] and [programmatically determined link context][] describes the purpose of the link.
 
 ## Assumptions
 
@@ -97,6 +97,28 @@ The [accessible name][] describes the purpose of the link.
 
 #### Passed Example 3
 
+The [accessible name][] together with the [accessible description][] describes the purpose of the link.
+
+```html
+<a href="#desc" title="See the product's description">More</a>
+
+<p id="desc">This product consists of several web pages.</p>
+```
+
+#### Passed Example 4
+
+The [accessible name][] together with the [accessible description][] describes the purpose of the link.
+
+```html
+<a href="#desc" aria-describedby="link-desc">More</a>
+
+<p id="link-desc" style="display: none">See the product's description.</p>
+
+<p id="desc">This product consists of several web pages.</p>
+```
+
+#### Passed Example 5
+
 The [accessible name][] (from the link's text), together with its [programmatically determined link context][] (available from the text in the closest `p` ancestor), describes the purpose of the link.
 
 ```html
@@ -105,7 +127,7 @@ The [accessible name][] (from the link's text), together with its [programmatica
 <p id="desc">This product consists of several web pages.</p>
 ```
 
-#### Passed Example 4
+#### Passed Example 6
 
 The [accessible name][] (from the link's text) describes the purpose of the link.
 
@@ -115,7 +137,7 @@ The [accessible name][] (from the link's text) describes the purpose of the link
 <p id="desc">This product consists of several web pages.</p>
 ```
 
-#### Passed Example 5
+#### Passed Example 7
 
 The [programmatically determined link context][] (provided by the ancestor with a role of `listitem` and text "Ulysses") and the [accessible name][] (from the link's text) describe the purpose of the links.
 
@@ -136,7 +158,7 @@ The [programmatically determined link context][] (provided by the ancestor with
 </ul>
 ```
 
-#### Passed Example 6
+#### Passed Example 8
 
 The [programmatically determined link context][] (provided by the table header [assigned](https://html.spec.whatwg.org/multipage/tables.html#algorithm-for-assigning-header-cells) to the cell containing the link) and the [accessible name][] (from the link's text) describe the purpose of the links.
 
@@ -157,7 +179,7 @@ The [programmatically determined link context][] (provided by the table header [
 </table>
 ```
 
-#### Passed Example 7
+#### Passed Example 9
 
 The [accessible name][] describes the purpose of the link.
 
@@ -179,7 +201,7 @@ The [accessible name][] describes the purpose of the link.
 </main>
 ```
 
-#### Passed Example 8
+#### Passed Example 10
 
 The [programmatically determined link context][] (provided by the cell containing the link) and the [accessible name][] (from the link's text) describe the purpose of the links.
 
@@ -200,7 +222,7 @@ The [programmatically determined link context][] (provided by the cell containin
 </table>
 ```
 
-#### Passed Example 9
+#### Passed Example 11
 
 The [programmatically determined link context][] (provided by the element referenced by the `aria-describedby` attribute) and the [accessible name][] (from the link's text) describe the purpose of the links.
 
@@ -338,6 +360,7 @@ This `a` element is not a [semantic][semantic role] `link`, because it has no `h
 ```
 
 [accessible name]: #accessible-name 'Definition of Accessible Name'
+[accessible description]: #accessible-description 'Definition of Accessible Description'
 [included in the accessibility tree]: #included-in-the-accessibility-tree 'Definition of Included in the Accessibility Tree'
 [presentational roles conflict resolution]: https://www.w3.org/TR/wai-aria-1.1/#conflict_resolution_presentation_none 'Presentational Roles Conflict Resolution'
 [programmatically determined link context]: #programmatically-determined-link-context 'Definition of Programmatically Determined Link Context'

_rules/links-with-identical-names-and-context-serve-equivalent-purpose-fd3a94.md

@@ -38,9 +38,10 @@ This rule applies to any set of two or more [HTML or SVG elements][] for which a
 - the elements are in the same [web page (HTML)][]; and
 - the elements are [included in the accessibility tree][included in the accessibility tree]; and
 - the elements have [matching][] [accessible names][accessible name] that are not empty (`""`); and
+- the elements have [matching][] [accessible descriptions][accessible description]; and
 - have the same [programmatically determined link context][].
 
-**Note:** The test target for this rule is the full set of link elements that share the same [matching][] [accessible name][] and [programmatically determined link context][].
+**Note:** The test target for this rule is the full set of link elements that share the same [matching][] [accessible name][], [accessible description][] and [programmatically determined link context][].
 
 ## Expectation
 
@@ -73,7 +74,7 @@ There is a difference between two contexts being the _same_ and being _identical
 
 #### Passed Example 1
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context] and link to the [same resource][].
+These two HTML `a` elements have the same non-empty [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and resolve to the [same resource][].
 
 ```html
 <html lang="en">
@@ -87,7 +88,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Passed Example 2
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context], and resolve to the [same resource][] after an instant redirect.
+These two HTML `a` elements have the same non-empty [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and resolve to the [same resource][] after an instant redirect.
 
 ```html
 <html lang="en">
@@ -102,7 +103,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Passed Example 3
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context], and resolve to identical resources.
+These two HTML `a` elements have the same non-empty [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and resolve to identical resources.
 
 ```html
 <html lang="en">
@@ -118,7 +119,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Passed Example 4
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context], and resolve to pages that serve the same purpose because the content section is the same.
+These two HTML `a` elements have the same [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and resolve to pages that serve the same purpose because the content section is the same.
 
 ```html
 <html lang="en">
@@ -134,7 +135,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Passed Example 5
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context], and go to pages that fulfill the same purpose in relation to the link because they contain the same relevant information.
+These two HTML `a` elements have the same [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and go to pages that fulfill the same purpose in relation to the link because they contain the same relevant information.
 
 ```html
 <html lang="en">
@@ -149,7 +150,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Passed Example 6
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context], and go to pages that use different layouts but have the same purpose.
+These two HTML `a` elements have the same [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and go to pages that use different layouts but have the same purpose.
 
 ```html
 <html lang="en">
@@ -165,7 +166,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Passed Example 7
 
-These two HTML `span` elements have an [explicit role][] of link, the same [accessible name][], the same [context][programmatically determined link context], and link to the [same resource][].
+These two HTML `span` elements have an [explicit role][] of link, the same [accessible name][], empty [accessible description][], the same [context][programmatically determined link context], and link to the [same resource][].
 
 ```html
 <html lang="en">
@@ -191,7 +192,7 @@ These two HTML `span` elements have an [explicit role][] of link, the same [acce
 
 #### Passed Example 8
 
-These two SVG `a` and HTML `a` elements have the same [accessible name][], same [context][programmatically determined link context] and link to the [same resource][].
+These two SVG `a` and HTML `a` elements have the same [accessible name][], empty [accessible description][], same [context][programmatically determined link context] and link to the [same resource][].
 
 ```html
 <html lang="en">
@@ -211,7 +212,7 @@ These two SVG `a` and HTML `a` elements have the same [accessible name][], same
 
 #### Failed Example 1
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context] but go to different resources.
+These two HTML `a` elements have the same [accessible name][], the same [accessible description][], and the same [context][programmatically determined link context], but go to different resources.
 
 ```html
 <html lang="en">
@@ -225,7 +226,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Failed Example 2
 
-These two HTML `a` elements have the same [accessible name][] and [context][programmatically determined link context]. They link to web pages that are similar, but have different information in their content.
+These two HTML `a` elements have the same [accessible name][], the same [accessible description][] and [context][programmatically determined link context]. They link to web pages that are similar, but have different information in their content.
 
 ```html
 <html lang="en">
@@ -242,7 +243,7 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 #### Failed Example 3
 
-These two HTML `span` elements have an [explicit role][] of link, same [accessible name][] and [context][programmatically determined link context], but link to resources that offer different content.
+These two HTML `span` elements have an [explicit role][] of link, the same [accessible name][], the same [accessible description][], and the same [context][programmatically determined link context], but link to resources that offer different content.
 
 ```html
 <html lang="en">
@@ -264,7 +265,7 @@ These two HTML `span` elements have an [explicit role][] of link, same [accessib
 
 #### Failed Example 4
 
-These two SVG `a` elements have the same [accessible name][] and [context][programmatically determined link context] but link to different resources.
+These two SVG `a` elements have the same [accessible name][], the same [accessible description][], and the same [context][programmatically determined link context], but link to different resources.
 
 ```html
 <html lang="en">
@@ -286,7 +287,7 @@ These two SVG `a` elements have the same [accessible name][] and [context][progr
 
 #### Failed Example 5
 
-These two HTML `a` elements with the same [accessible name][] and [context][programmatically determined link context] resolve to the [same resource][] after redirect, but the redirect is not instant.
+These two HTML `a` elements with the same [accessible name][], the same [accessible description][], and the same [context][programmatically determined link context], resolve to the [same resource][] after redirect, but the redirect is not instant.
 
 ```html
 <html lang="en">
@@ -331,7 +332,28 @@ These two HTML `a` elements have different [accessible names][accessible name].
 
 #### Inapplicable Example 3
 
-These two HTML `a` elements have the same [accessible name][] and link to the [same resource][] but different [programmatically determined link contexts][programmatically determined link context].
+These two HTML `a` elements have the same [accessible names][accessible name] but different [accessible descriptions][accessible description].
+
+```html
+<html lang="en">
+	<p>
+		<a
+			href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/about/contact.html"
+			title="To learn more about us"
+			>Contact</a
+		>
+		<a
+			href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/about/contact.html"
+			title="To know how to reach us"
+			>Contact</a
+		>
+	</p>
+</html>
+```
+
+#### Inapplicable Example 4
+
+These two HTML `a` elements have the same [accessible name][], , the same [accessible description][], and link to the [same resource][] but different [programmatically determined link contexts][programmatically determined link context].
 
 ```html
 <html lang="en">
@@ -348,7 +370,7 @@ These two HTML `a` elements have the same [accessible name][] and link to the [s
 </html>
 ```
 
-#### Inapplicable Example 4
+#### Inapplicable Example 5
 
 These two `span` elements do not have a [semantic role][] of link.
 
@@ -366,9 +388,9 @@ These two `span` elements do not have a [semantic role][] of link.
 </html>
 ```
 
-#### Inapplicable Example 5
+#### Inapplicable Example 6
 
-These two HTML `a` elements have the same [accessible name][] and link to the [same resource][] but different [programmatically determined link contexts][programmatically determined link context]. Even though the two contexts in this example are _identical_, they are not the _same_. That is: even though they have equivalent content, they do not consist of the same DOM elements.
+These two HTML `a` elements have the same [accessible name][], the same [accessible description][], and link to the [same resource][] but different [programmatically determined link contexts][programmatically determined link context]. Even though the two contexts in this example are *identical*, they are not the *same*. That is: even though they have equivalent content, they do not consist of the same DOM elements.
 
 ```html
 <html lang="en">
@@ -383,16 +405,17 @@ These two HTML `a` elements have the same [accessible name][] and link to the [s
 </html>
 ```
 
-#### Inapplicable Example 6
+#### Inapplicable Example 7
 
-These two HTML `a` elements have the same [accessible name][] but different [programmatically determined link contexts][programmatically determined link context] because the `div` elements place them in different display blocks.
+These two HTML `a` elements have the same [accessible name][], the same [accessible description][], but different [programmatically determined link contexts][programmatically determined link context] because the `div` elements place them in different display blocks.
 
 ```html
 <div><a href="https://www.w3.org/WAI/">Read more</a> about the W3C WAI</div>
 <div><a href="https://www.w3.org/International/">Read more</a> about the W3C internationalization</div>
 ```
 
 [accessible name]: #accessible-name 'Definition of accessible name'
+[accessible description]: #accessible-description 'Definition of Accessible Description'
 [document]: https://dom.spec.whatwg.org/#concept-document 'Definition of document'
 [explicit role]: #explicit-role 'Definition of explicit role'
 [included in the accessibility tree]: #included-in-the-accessibility-tree 'Definition of included in the accessibility tree'

pages/glossary/accessible-description.md

@@ -0,0 +1,21 @@
+---
+title: Accessible Description
+key: accessible-description
+unambiguous: true
+objective: true
+input_aspects:
+  - Accessibility tree
+  - CSS styling
+  - DOM tree
+---
+
+The _accessible description_ is the programmatically determined description of a user interface element that is [included in the accessibility tree](#included-in-the-accessibility-tree). The accessible description provides information that complements the [accessible name][].
+
+The accessible description is calculated using the [accessible name and description computation][].
+
+For native markup languages, such as HTML and SVG, additional information on how to calculate the accessible description can be found in [HTML Accessibility API Mappings 1.0, Accessible Name and Description Computation (working draft)](https://www.w3.org/TR/html-aam/#accessible-name-and-description-computation) and [SVG Accessibility API Mappings, Name and Description (working draft)](https://www.w3.org/TR/svg-aam/#mapping_additional).
+
+**Note:** As per the [accessible name and description computation][], each element with the 'aria-describedby' property always has an accessible description.
+
+[accessible name]: #accessible-name 'Definition of Accessible Name'
+[accessible name and description computation]: https://www.w3.org/TR/accname 'Accessible Name and Description Computation'

pages/glossary/programmatically-determined-link-context.md

@@ -13,8 +13,7 @@ The _programmatically determined context_ of a link (or _programmatically determ
 - being an [ancestor][] of the link in the [flat tree][] with a [semantic role][] of `listitem`; or
 - being the closest [ancestor][] of the link in the [flat tree][] that generates a [block container][]; or
 - being the closest [ancestor][] of the link in the [flat tree][] that has a [semantic role][] of `cell` or `gridcell`; or
-- being a header cell [assigned][] to the closest [ancestor][] of the link in the [flat tree][] that has a [semantic role][] of `cell` or `gridcell`; or
-- being referenced by an `aria-describedby` attribute of the link.
+- being a header cell [assigned][] to the closest [ancestor][] of the link in the [flat tree][] that has a [semantic role][] of `cell` or `gridcell`.
 
 This definition is based on (but not equivalent to) the [WCAG definition of programmatically determined link context](https://www.w3.org/TR/WCAG21/#dfn-programmatically-determined-link-context).