From 6bfb35cf06064712ac84d5fc99864a78c807a269 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Tue, 4 Jun 2024 17:46:57 -0700
Subject: [PATCH 01/10] #33034: accessible description

fixes #33034
---
 files/en-us/glossary/accessible_description/index.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index c42ef0e3bf6e701..f5cfd526402acd0 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -6,15 +6,15 @@ page-type: glossary-definition
 
 {{GlossarySidebar}}
 
-An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}.
+An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}, providing users with additional context about its purpose. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}.
 
-An element's accessible description is part of the {{glossary("accessibility tree")}} that makes web content available to {{glossary("Screen_reader", "screen readers")}} and other assistive technologies, which, in turn, make that content available to the users of those technologies.
+If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. In these cases, the accessible description is provided by the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute, [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute, or the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute, if the `title` would not otherwise also be the {{glossary("accessible name")}} for that element, in that order of precedence.
 
-The accessible description for a {{htmlelement("table")}} is its first {{htmlelement("caption")}}, for the {{htmlelement("figure")}}, is the {{htmlelement("figcaption")}}, for the {{htmlelement("summary")}}, is the content of the {{htmlelement("details")}} it is nested in, and for the button {{htmlelement("input")}} elements, it is the `value` attribute's value, unless the element also has a `aria-describedby` or `aria-description` attribute, which takes precedence.
+The accessible description provides additional information beyond an accessible name. For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with it's description.
 
-For other elements, the description needs to be programmatically associated with the related element. In these cases, the accessible description is provided by the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute, [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute, or the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute, if the `title` would not otherwise also be the {{glossary("accessible name")}} for that element, in that order of precedence.
+Similarly, when a user is asked to create a password, the `<label>` for the {{htmlelement("input")}} of type `password` provides its accessible name. A good accessible description includes the requirements for the password is a way that is visible to all users. It can be explicitly associated with the input via it's `aria-describedby` attribute, which adds it to the accessibility tree as the 'description' for that node.
 
-Descriptions are reduced to text strings. For example, if an element's `aria-describedby` attribute value is the `id` of an HTML {{htmlelement("img")}}, the description is the description of the image (usually the image's `alt` attribute).
+Descriptions are reduced to text strings. In our password example, if the inputs's `aria-describedby` attribute value is the `id` of an HTML {{htmlelement("ul")}} with a list of requirements, the description is concatenated text and text equivalents of all the list items.
 
 You can inspect the accessible description for any element on your page: look at your browser's developer tools' accessibility tab, which provides the accessibility information for the currently selected element.
 

From e91889ceb46fa950333f3fdcdaadf0d9c3e57cd2 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Tue, 11 Jun 2024 13:45:22 -0700
Subject: [PATCH 02/10] Apply suggestions from code review

Co-authored-by: Hoarfroster <hoarfroster@outlook.com>
---
 .../glossary/accessible_description/index.md  | 27 +++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index f5cfd526402acd0..d4caf28b9a46bcd 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -6,14 +6,37 @@ page-type: glossary-definition
 
 {{GlossarySidebar}}
 
-An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}, providing users with additional context about its purpose. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}.
+An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML or SVG element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}, providing users with additional context about its purpose. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}.
 
-If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. In these cases, the accessible description is provided by the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute, [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute, or the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute, if the `title` would not otherwise also be the {{glossary("accessible name")}} for that element, in that order of precedence.
+## Computation
+
+### HTML
+
+For HTML elements, the description needs to be programmatically associated with the related element. If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. In these cases, the accessible description is. as is defined in HTML-AAM:
+
+1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute.
+2. [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute.
+3. HTML-specific features:
+
+  1. {htmlelement("table")}}: its first {{htmlelement("caption")}}.
+  2. {{htmlelement("summary")}}: the content of {{htmlelement("details")}} it is nested in.
+  3. {{htmlelement("input")}} buttons(with type attribute `button`, `submit` or `reset`): the `value` attribute's value.
+
+4.  [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute, if the `title` would not otherwise also be the {{glossary("accessible name")}} for that element.
 
 The accessible description provides additional information beyond an accessible name. For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with it's description.
 
 Similarly, when a user is asked to create a password, the `<label>` for the {{htmlelement("input")}} of type `password` provides its accessible name. A good accessible description includes the requirements for the password is a way that is visible to all users. It can be explicitly associated with the input via it's `aria-describedby` attribute, which adds it to the accessibility tree as the 'description' for that node.
 
+### SVG
+
+Like the computation of the HTML elements, SVG elements also have their accessible description computed, as is defined in SVG-AAM:
+
+1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute;
+2. a direct child [`desc`](/en-US/docs/Web/SVG/Element/desc) element
+3. for text container elements, the text content
+4. a direct child title element that provides a tooltip, when ARIA label attributes are used to provide the accessible name
+5. [`xlink:title`](/en-US/docs/Web/SVG/Attribute/xlink:title) attribute on a link, if not used to provide the accessible name
 Descriptions are reduced to text strings. In our password example, if the inputs's `aria-describedby` attribute value is the `id` of an HTML {{htmlelement("ul")}} with a list of requirements, the description is concatenated text and text equivalents of all the list items.
 
 You can inspect the accessible description for any element on your page: look at your browser's developer tools' accessibility tab, which provides the accessibility information for the currently selected element.

From 6c50e4b348dd0831200880bf86ef542553e82933 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Tue, 11 Jun 2024 14:01:55 -0700
Subject: [PATCH 03/10] see also

---
 files/en-us/glossary/accessible_description/index.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index d4caf28b9a46bcd..bcb5448b4c3b124 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -48,3 +48,7 @@ You can inspect the accessible description for any element on your page: look at
 - [ARIA attribute](/en-US/docs/Web/Accessibility/ARIA/Attributes)
 - [Accessibility](/en-US/docs/Web/Accessibility)
 - [Learn accessibility](/en-US/docs/Learn/Accessibility)
+- [WAI-ARIA](https://www.w3.org/TR/wai-aria-implementation/)
+- [Accessible Name Description](https://www.w3.org/TR/accname-1.2/#mapping_additional_nd_description)
+- [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)
+- [SVG-AAM Accessible Description](https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd)

From cb868d4a3bb1ff60f81048f4af1387b70edde969 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Tue, 11 Jun 2024 14:29:12 -0700
Subject: [PATCH 04/10] rework the suggested edits

---
 .../glossary/accessible_description/index.md  | 45 ++++++++++---------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index bcb5448b4c3b124..16fa8f88381363b 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -8,38 +8,44 @@ page-type: glossary-definition
 
 An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML or SVG element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}, providing users with additional context about its purpose. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}.
 
+The accessible description provides additional information beyond an accessible name. For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with it's description.
+
+Similarly, when a user is asked to create a password, the `<label>` for the {{htmlelement("input")}} of type `password` provides its accessible name. A good accessible description includes the requirements for the password is a way that is visible to all users. It can be explicitly associated with the input via it's `aria-describedby` attribute, which adds it to the accessibility tree as the 'description' for that node.
+
+Descriptions are reduced to text strings. In our password example, if the inputs's `aria-describedby` attribute value is the `id` of an HTML {{htmlelement("ul")}} with a list of requirements, the description is concatenated text and text equivalents of all the list items.
+
+You can inspect the accessible description for any element on your page: look at your browser's developer tools' accessibility tab, which provides the accessibility information for the currently selected element.
+
 ## Computation
 
 ### HTML
 
-For HTML elements, the description needs to be programmatically associated with the related element. If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. In these cases, the accessible description is. as is defined in HTML-AAM:
+For HTML elements, the description needs to be programmatically associated with the related element. If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. The accessible description is computed in the following order of precendence (defined by [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)):
 
 1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute.
+  
 2. [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute.
-3. HTML-specific features:
 
-  1. {htmlelement("table")}}: its first {{htmlelement("caption")}}.
-  2. {{htmlelement("summary")}}: the content of {{htmlelement("details")}} it is nested in.
-  3. {{htmlelement("input")}} buttons(with type attribute `button`, `submit` or `reset`): the `value` attribute's value.
+3. HTML-specific features can participate in the description computation if they are not already used for the {{glossary("accessible name")}}. For example:
 
-4.  [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute, if the `title` would not otherwise also be the {{glossary("accessible name")}} for that element.
+  * A {{htmlelement("summary")}} is described by the content of {{htmlelement("details")}} it is nested in.
+  * {{htmlelement("input")}} buttons (with type attribute `button`, `submit` or `reset`) are described by their `value` attribute's value.
 
-The accessible description provides additional information beyond an accessible name. For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with it's description.
-
-Similarly, when a user is asked to create a password, the `<label>` for the {{htmlelement("input")}} of type `password` provides its accessible name. A good accessible description includes the requirements for the password is a way that is visible to all users. It can be explicitly associated with the input via it's `aria-describedby` attribute, which adds it to the accessibility tree as the 'description' for that node.
+4.  If none of the above provide a description, the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute is used, if the `title` is not the {{glossary("accessible name")}} for that element.
 
 ### SVG
 
-Like the computation of the HTML elements, SVG elements also have their accessible description computed, as is defined in SVG-AAM:
+Like the computation of the HTML elements, SVG elements also have their accessible description computed (defined by [SVG-AAM Accessible Description](https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd)), in the following order of precedence:
 
-1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute;
-2. a direct child [`desc`](/en-US/docs/Web/SVG/Element/desc) element
-3. for text container elements, the text content
-4. a direct child title element that provides a tooltip, when ARIA label attributes are used to provide the accessible name
-5. [`xlink:title`](/en-US/docs/Web/SVG/Attribute/xlink:title) attribute on a link, if not used to provide the accessible name
-Descriptions are reduced to text strings. In our password example, if the inputs's `aria-describedby` attribute value is the `id` of an HTML {{htmlelement("ul")}} with a list of requirements, the description is concatenated text and text equivalents of all the list items.
+1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute
 
-You can inspect the accessible description for any element on your page: look at your browser's developer tools' accessibility tab, which provides the accessibility information for the currently selected element.
+2. The content of its [`<desc>`](/en-US/docs/Web/SVG/Element/desc) element (the SVG [`<title>`](/en-US/docs/Web/SVG/Element/title) provides the accessible name). 
+
+3. From the text contained in descendant text container elements (i.e. [`<text>`](/en-US/docs/Web/SVG/Element/text)), if they are not already used for the {{glossary("accessible name")}}
+
+4. The SVG [`<title>`](/en-US/docs/Web/SVG/Element/title) element that provides a tooltip, when the accessible name is provided by ARIA label attributes instead of the `<title>`
+
+5. The [`xlink:title`](/en-US/docs/Web/SVG/Attribute/xlink:title) attribute on a link, if not used to provide the accessible name
 
 ## See also
 
@@ -48,7 +54,4 @@ You can inspect the accessible description for any element on your page: look at
 - [ARIA attribute](/en-US/docs/Web/Accessibility/ARIA/Attributes)
 - [Accessibility](/en-US/docs/Web/Accessibility)
 - [Learn accessibility](/en-US/docs/Learn/Accessibility)
-- [WAI-ARIA](https://www.w3.org/TR/wai-aria-implementation/)
-- [Accessible Name Description](https://www.w3.org/TR/accname-1.2/#mapping_additional_nd_description)
-- [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)
-- [SVG-AAM Accessible Description](https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd)
+- [Accessible description computation 1.2](https://w3c.github.io/accname/#mapping_additional_nd_description) via w3.github.io/accname

From 0913c5a1231bd1e3138e437ce12dcdfb360532a4 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Tue, 11 Jun 2024 14:30:54 -0700
Subject: [PATCH 05/10] Update
 files/en-us/glossary/accessible_description/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 files/en-us/glossary/accessible_description/index.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index 16fa8f88381363b..fe3175f53ee674b 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -23,7 +23,6 @@ You can inspect the accessible description for any element on your page: look at
 For HTML elements, the description needs to be programmatically associated with the related element. If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. The accessible description is computed in the following order of precendence (defined by [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)):
 
 1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute.
-  
 2. [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute.
 
 3. HTML-specific features can participate in the description computation if they are not already used for the {{glossary("accessible name")}}. For example:

From d77234ebe78c1cdaee48159cd8e84e0e6de42d6a Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Tue, 11 Jun 2024 14:31:38 -0700
Subject: [PATCH 06/10] Apply suggestions from code review

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 files/en-us/glossary/accessible_description/index.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index fe3175f53ee674b..f767a4eb4ac41b0 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -27,10 +27,10 @@ For HTML elements, the description needs to be programmatically associated with
 
 3. HTML-specific features can participate in the description computation if they are not already used for the {{glossary("accessible name")}}. For example:
 
-  * A {{htmlelement("summary")}} is described by the content of {{htmlelement("details")}} it is nested in.
-  * {{htmlelement("input")}} buttons (with type attribute `button`, `submit` or `reset`) are described by their `value` attribute's value.
+- A {{htmlelement("summary")}} is described by the content of {{htmlelement("details")}} it is nested in.
+- {{htmlelement("input")}} buttons (with type attribute `button`, `submit` or `reset`) are described by their `value` attribute's value.
 
-4.  If none of the above provide a description, the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute is used, if the `title` is not the {{glossary("accessible name")}} for that element.
+4. If none of the above provide a description, the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute is used, if the `title` is not the {{glossary("accessible name")}} for that element.
 
 ### SVG
 
@@ -38,7 +38,7 @@ Like the computation of the HTML elements, SVG elements also have their accessib
 
 1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute
 
-2. The content of its [`<desc>`](/en-US/docs/Web/SVG/Element/desc) element (the SVG [`<title>`](/en-US/docs/Web/SVG/Element/title) provides the accessible name). 
+2. The content of its [`<desc>`](/en-US/docs/Web/SVG/Element/desc) element (the SVG [`<title>`](/en-US/docs/Web/SVG/Element/title) provides the accessible name).
 
 3. From the text contained in descendant text container elements (i.e. [`<text>`](/en-US/docs/Web/SVG/Element/text)), if they are not already used for the {{glossary("accessible name")}}
 

From 67ef601c1c543e6b227f8aba2e2ed1c38ec7f034 Mon Sep 17 00:00:00 2001
From: estelle <estelle@openwebdocs.org>
Date: Tue, 11 Jun 2024 14:34:51 -0700
Subject: [PATCH 07/10] layout

---
 files/en-us/glossary/accessible_description/index.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index f767a4eb4ac41b0..0ba3363c12e988f 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -23,12 +23,13 @@ You can inspect the accessible description for any element on your page: look at
 For HTML elements, the description needs to be programmatically associated with the related element. If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. The accessible description is computed in the following order of precendence (defined by [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)):
 
 1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute.
+
 2. [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute.
 
 3. HTML-specific features can participate in the description computation if they are not already used for the {{glossary("accessible name")}}. For example:
 
-- A {{htmlelement("summary")}} is described by the content of {{htmlelement("details")}} it is nested in.
-- {{htmlelement("input")}} buttons (with type attribute `button`, `submit` or `reset`) are described by their `value` attribute's value.
+   - A {{htmlelement("summary")}} is described by the content of {{htmlelement("details")}} it is nested in.
+   - {{htmlelement("input")}} buttons (with type attribute `button`, `submit` or `reset`) are described by their `value` attribute's value.
 
 4. If none of the above provide a description, the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute is used, if the `title` is not the {{glossary("accessible name")}} for that element.
 

From 5cb38d69de8f32ff2420043512daec29c770f700 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Thu, 13 Jun 2024 08:51:05 -0700
Subject: [PATCH 08/10] Update
 files/en-us/glossary/accessible_description/index.md

Co-authored-by: Hoarfroster <hoarfroster@outlook.com>
---
 .../glossary/accessible_description/index.md     | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index 0ba3363c12e988f..df26e114cbc9a07 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -49,9 +49,17 @@ Like the computation of the HTML elements, SVG elements also have their accessib
 
 ## See also
 
-- {{glossary("accessible name")}} glossary term
-- [ARIA roles](/en-US/docs/Web/Accessibility/ARIA/Roles)
-- [ARIA attribute](/en-US/docs/Web/Accessibility/ARIA/Attributes)
+- [Accessible Name and Description Computation 1.2 (accname)](https://w3c.github.io/accname/#mapping_additional_nd_description)
 - [Accessibility](/en-US/docs/Web/Accessibility)
 - [Learn accessibility](/en-US/docs/Learn/Accessibility)
-- [Accessible description computation 1.2](https://w3c.github.io/accname/#mapping_additional_nd_description) via w3.github.io/accname
+- [Web accessibility](https://en.wikipedia.org/wiki/Web_accessibility) on Wikipedia
+- [Web Accessibility In Mind](https://webaim.org/)
+- [ARIA](/en-US/docs/Web/Accessibility/ARIA)
+- [The W3C Web Accessibility Initiative (WAI)](https://www.w3.org/WAI/)
+- [Accessible Rich Internet Applications (WAI-ARIA)](https://w3c.github.io/aria/)
+- [Glossary](/en-US/docs/Glossary)
+
+  - {{Glossary("Accessibility")}}
+  - {{Glossary("Accessibility tree")}}
+  - {{Glossary("Accessible name")}}
+  - {{Glossary("ARIA")}}

From 5b4efaf630a211563766c4ce2c161291176aeb28 Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Thu, 13 Jun 2024 09:03:59 -0700
Subject: [PATCH 09/10] combine svg and html computations

---
 .../glossary/accessible_description/index.md  | 23 +++++--------------
 1 file changed, 6 insertions(+), 17 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index df26e114cbc9a07..28724b4e5f23ae7 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -16,36 +16,25 @@ Descriptions are reduced to text strings. In our password example, if the inputs
 
 You can inspect the accessible description for any element on your page: look at your browser's developer tools' accessibility tab, which provides the accessibility information for the currently selected element.
 
-## Computation
+## Accessible description computation
 
-### HTML
-
-For HTML elements, the description needs to be programmatically associated with the related element. If an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. The accessible description is computed in the following order of precendence (defined by [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)):
+For HTML elements, if an element doesn't have an accessible description, the description needs to be programmatically associated with the related element. The accessibility object model (AOM) computes the accessible description by checking this features, in order, until it is defined:
 
 1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute.
 
 2. [`aria-description`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description) attribute.
 
-3. HTML-specific features can participate in the description computation if they are not already used for the {{glossary("accessible name")}}. For example:
+3. Language-specific features that participate in the description computation if the feature is not already being used to define the {{glossary("accessible name")}}. For example:
 
    - A {{htmlelement("summary")}} is described by the content of {{htmlelement("details")}} it is nested in.
    - {{htmlelement("input")}} buttons (with type attribute `button`, `submit` or `reset`) are described by their `value` attribute's value.
+   - In SVG, the content of the [`<desc>`](/en-US/docs/Web/SVG/Element/desc) element, if present, otherwise, the text contained in descendant text container elements (i.e. [`<text>`](/en-US/docs/Web/SVG/Element/text)), if they are not already used for the {{glossary("accessible name")}}
 
 4. If none of the above provide a description, the [`title`](/en-US/docs/Web/HTML/Global_attributes#title) attribute is used, if the `title` is not the {{glossary("accessible name")}} for that element.
 
-### SVG
-
-Like the computation of the HTML elements, SVG elements also have their accessible description computed (defined by [SVG-AAM Accessible Description](https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd)), in the following order of precedence:
-
-1. [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute
-
-2. The content of its [`<desc>`](/en-US/docs/Web/SVG/Element/desc) element (the SVG [`<title>`](/en-US/docs/Web/SVG/Element/title) provides the accessible name).
-
-3. From the text contained in descendant text container elements (i.e. [`<text>`](/en-US/docs/Web/SVG/Element/text)), if they are not already used for the {{glossary("accessible name")}}
-
-4. The SVG [`<title>`](/en-US/docs/Web/SVG/Element/title) element that provides a tooltip, when the accessible name is provided by ARIA label attributes instead of the `<title>`
+5. If none of the above defines an accessible description, the accessible description is empty.
 
-5. The [`xlink:title`](/en-US/docs/Web/SVG/Attribute/xlink:title) attribute on a link, if not used to provide the accessible name
+The steps for defining accessible description in HTML are defined in the [HTML-AAM Accessible Description](https://www.w3.org/TR/html-aam-1.0/#accdesc-computation)). Accessible description for SVG elements follow the same steps with small differences that are enumerated at [SVG-AAM Accessible Description](https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd)).
 
 ## See also
 

From f0ad4500ae54574bb973a905dae7f85cedf8e9cf Mon Sep 17 00:00:00 2001
From: Estelle Weyl <estelle@weyl.org>
Date: Thu, 20 Jun 2024 11:26:42 -0700
Subject: [PATCH 10/10] Apply suggestions from code review

Co-authored-by: Vadim Makeev <hi@pepelsbey.dev>
---
 files/en-us/glossary/accessible_description/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md
index 28724b4e5f23ae7..cd002f3d0a1c428 100644
--- a/files/en-us/glossary/accessible_description/index.md
+++ b/files/en-us/glossary/accessible_description/index.md
@@ -6,9 +6,9 @@ page-type: glossary-definition
 
 {{GlossarySidebar}}
 
-An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML or SVG element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}, providing users with additional context about its purpose. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}.
+An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It's associated with an HTML or SVG element and gives users additional context about its purpose beyond what is provided by the element's {{glossary("accessible name")}}. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}.
 
-The accessible description provides additional information beyond an accessible name. For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with it's description.
+For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table, both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with its description.
 
 Similarly, when a user is asked to create a password, the `<label>` for the {{htmlelement("input")}} of type `password` provides its accessible name. A good accessible description includes the requirements for the password is a way that is visible to all users. It can be explicitly associated with the input via it's `aria-describedby` attribute, which adds it to the accessibility tree as the 'description' for that node.