fix: fix grammar when using "alternative text" in a sentence (#4811)

notoriousmango · web-flow · commit 237a5861b0fb · 2025-07-02T09:53:15.000-06:00
<< Describe the changes >> Remove unnecessary articles Closes: #4394
diff --git a/doc/rule-descriptions.md b/doc/rule-descriptions.md
@@ -70,7 +70,7 @@
 | [select-name](https://dequeuniversity.com/rules/axe/4.10/select-name?application=RuleDescription)                                 | Ensure select element has an accessible name                                                                                                         | Critical | cat.forms, wcag2a, wcag412, section508, section508.22.n, TTv5, TT5.c, EN-301-549, EN-9.4.1.2, ACT                                  | failure, needs&nbsp;review | [e086e5](https://act-rules.github.io/rules/e086e5)                                                                                                                                                                                                                 |
 | [server-side-image-map](https://dequeuniversity.com/rules/axe/4.10/server-side-image-map?application=RuleDescription)             | Ensure that server-side image maps are not used                                                                                                      | Minor    | cat.text-alternatives, wcag2a, wcag211, section508, section508.22.f, TTv5, TT4.a, EN-301-549, EN-9.2.1.1                           | needs&nbsp;review          |                                                                                                                                                                                                                                                                    |
 | [summary-name](https://dequeuniversity.com/rules/axe/4.10/summary-name?application=RuleDescription)                               | Ensure summary elements have discernible text                                                                                                        | Serious  | cat.name-role-value, wcag2a, wcag412, section508, section508.22.a, TTv5, TT6.a, EN-301-549, EN-9.4.1.2                             | failure, needs&nbsp;review |                                                                                                                                                                                                                                                                    |
-| [svg-img-alt](https://dequeuniversity.com/rules/axe/4.10/svg-img-alt?application=RuleDescription)                                 | Ensure &lt;svg&gt; elements with an img, graphics-document or graphics-symbol role have an accessible text                                           | Serious  | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, TTv5, TT7.a, EN-301-549, EN-9.1.1.1, ACT                      | failure, needs&nbsp;review | [7d6734](https://act-rules.github.io/rules/7d6734)                                                                                                                                                                                                                 |
+| [svg-img-alt](https://dequeuniversity.com/rules/axe/4.10/svg-img-alt?application=RuleDescription)                                 | Ensure &lt;svg&gt; elements with an img, graphics-document or graphics-symbol role have accessible text                                              | Serious  | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, TTv5, TT7.a, EN-301-549, EN-9.1.1.1, ACT                      | failure, needs&nbsp;review | [7d6734](https://act-rules.github.io/rules/7d6734)                                                                                                                                                                                                                 |
 | [td-headers-attr](https://dequeuniversity.com/rules/axe/4.10/td-headers-attr?application=RuleDescription)                         | Ensure that each cell in a table that uses the headers attribute refers only to other &lt;th&gt; elements in that table                              | Serious  | cat.tables, wcag2a, wcag131, section508, section508.22.g, TTv5, TT14.b, EN-301-549, EN-9.1.3.1                                     | failure, needs&nbsp;review | [a25f45](https://act-rules.github.io/rules/a25f45)                                                                                                                                                                                                                 |
 | [th-has-data-cells](https://dequeuniversity.com/rules/axe/4.10/th-has-data-cells?application=RuleDescription)                     | Ensure that &lt;th&gt; elements and elements with role=columnheader/rowheader have data cells they describe                                          | Serious  | cat.tables, wcag2a, wcag131, section508, section508.22.g, TTv5, TT14.b, EN-301-549, EN-9.1.3.1                                     | failure, needs&nbsp;review | [d0f69e](https://act-rules.github.io/rules/d0f69e)                                                                                                                                                                                                                 |
 | [valid-lang](https://dequeuniversity.com/rules/axe/4.10/valid-lang?application=RuleDescription)                                   | Ensure lang attributes have valid values                                                                                                             | Serious  | cat.language, wcag2aa, wcag312, TTv5, TT11.b, EN-301-549, EN-9.3.1.2, ACT                                                          | failure                    | [de46e4](https://act-rules.github.io/rules/de46e4)                                                                                                                                                                                                                 |
diff --git a/lib/rules/role-img-alt.json b/lib/rules/role-img-alt.json
@@ -18,7 +18,7 @@
   "actIds": ["23a2a8"],
   "metadata": {
     "description": "Ensure [role=\"img\"] elements have alternative text",
-    "help": "[role=\"img\"] elements must have an alternative text"
+    "help": "[role=\"img\"] elements must have alternative text"
   },
   "all": [],
   "any": ["aria-label", "aria-labelledby", "non-empty-title"],
diff --git a/lib/rules/svg-img-alt.json b/lib/rules/svg-img-alt.json
@@ -17,8 +17,8 @@
   ],
   "actIds": ["7d6734"],
   "metadata": {
-    "description": "Ensure <svg> elements with an img, graphics-document or graphics-symbol role have an accessible text",
-    "help": "<svg> elements with an img role must have an alternative text"
+    "description": "Ensure <svg> elements with an img, graphics-document or graphics-symbol role have accessible text",
+    "help": "<svg> elements with an img role must have alternative text"
   },
   "all": [],
   "any": [
diff --git a/locales/_template.json b/locales/_template.json
@@ -351,7 +351,7 @@
     },
     "role-img-alt": {
       "description": "Ensure [role=\"img\"] elements have alternative text",
-      "help": "[role=\"img\"] elements must have an alternative text"
+      "help": "[role=\"img\"] elements must have alternative text"
     },
     "scope-attr-valid": {
       "description": "Ensure the scope attribute is used correctly on tables",
@@ -378,8 +378,8 @@
       "help": "Summary elements must have discernible text"
     },
     "svg-img-alt": {
-      "description": "Ensure <svg> elements with an img, graphics-document or graphics-symbol role have an accessible text",
-      "help": "<svg> elements with an img role must have an alternative text"
+      "description": "Ensure <svg> elements with an img, graphics-document or graphics-symbol role have accessible text",
+      "help": "<svg> elements with an img role must have alternative text"
     },
     "tabindex": {
       "description": "Ensure tabindex attribute values are not greater than 0",
