From c9343adc7826c3909f5d3f4e197348fe3f0ac13d Mon Sep 17 00:00:00 2001
From: scottaohara <scottaohara@gmail.com>
Date: Wed, 4 Aug 2021 11:23:19 -0400
Subject: [PATCH] Editorial: attribute rules consistency wording/linking

consistent sentence phrasing / linking of `aria-*` attribute for
* `aria-checked`
* `aria-disabled`
* `aria-hidden`
* `aria-placeholder`
* `aria-valuemax`
* `aria-valuemin`
* `aria-readonly`
* `aria-required`

updates to `aria-colspan` and `aria-rowspan` will be part of another PR
---
 index.html | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/index.html b/index.html
index 8829fa66..4aa8f1b5 100644
--- a/index.html
+++ b/index.html
@@ -2904,7 +2904,7 @@ <h3 id="docconformance-attr">
                   allowed the `checked` attribute in HTML.
                 </p>
                 <p>
-                  Authors SHOULD NOT use the `aria-checked` attribute on any element where the <a data-cite="html/form-control-infrastructure.html#concept-fe-checked">checkedness</a> of the element can be in opposition to the current value of the <a data-cite="wai-aria-1.1#aria-checked">`aria-checked` attribute</a>.
+                  Authors SHOULD NOT use the <a data-cite="wai-aria-1.1#aria-checked">`aria-checked`</a> attribute on any element where the <a data-cite="html/form-control-infrastructure.html#concept-fe-checked">checkedness</a> of the element can be in opposition to the current value of the `aria-checked` attribute.
                 </p>
                 <p>
                   Authors MAY use the `aria-checked` attribute on any other element with a WAI-ARIA role which allows the  attribute.
@@ -2926,7 +2926,7 @@ <h3 id="docconformance-attr">
                   Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML.
                 </p>
                 <p>
-                  Authors MAY use the `aria-disabled` attribute on any element that is allowed the `disabled` attribute in HTML, or any element with a WAI-ARIA role which allows the <a data-cite="wai-aria-1.1#aria-disabled">`aria-disabled` attribute</a>.
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-disabled">`aria-disabled`</a> attribute on any element that is allowed the `disabled` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-disabled` attribute</a>.
                 </p>
                 <p>
                   Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute.
@@ -2945,7 +2945,7 @@ <h3 id="docconformance-attr">
               </td>
               <td>
                 <p>
-                  Authors MAY use the `aria-hidden` attribute on any HTML element that allows <a data-cite="wai-aria-1.1#global_states">global `aria-*` attributes</a>, with the following exception:
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-hidden">`aria-hidden`</a> attribute on any HTML element that allows <a data-cite="wai-aria-1.1#global_states">global `aria-*` attributes</a>, with the following exception:
                 </p>
                 <p>
                   Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute.
@@ -2973,7 +2973,7 @@ <h3 id="docconformance-attr">
                   `placeholder` attribute in HTML.
                 </p>
                 <p>
-                  Authors MAY use the `aria-placeholder` attribute on any element that is allowed the `placeholder` attribute in HTML, or any element with a WAI-ARIA role which allows the <a data-cite="wai-aria-1.1#aria-placeholder">`aria-placeholder` attribute</a>.
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-placeholder">`aria-placeholder`</a> attribute on any element that is allowed the `placeholder` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute.
                 </p>
                 <p>
                   Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute.
@@ -2993,13 +2993,13 @@ <h3 id="docconformance-attr">
                   allowed the `max` attribute in HTML.
                 </p>
                 <p>
-                  Authors MAY use the `aria-valuemax` attribute on any other element with a WAI-ARIA role which allows the attribute.
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-valuemax">`aria-valuemax`</a> attribute on any other element with a WAI-ARIA role which allows the `aria-valuemax` attribute.
                 </p>
                 <p>
                   Authors SHOULD NOT use `aria-valuemax` on any element which allows the `max` attribute. Use the `max` attribute instead.
                 </p>
                 <p>
-                  Authors MUST NOT use `aria-valuemax` on any element which also has a `max` attribute, even if the values of each attribute match.
+                  Authors MUST NOT use `aria-valuemax` on any element which also has a `max` attribute.
                 </p>
               </td>
             </tr>
@@ -3016,13 +3016,13 @@ <h3 id="docconformance-attr">
                   allowed the `min` attribute in HTML.
                 </p>
                 <p>
-                  Authors MAY use the `aria-valuemin` attribute on any other element with a WAI-ARIA role which allows the attribute.
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-valuemax">`aria-valuemin`</a> attribute on any other element with a WAI-ARIA role which allows the `aria-valuemin` attribute.
                 </p>
                 <p>
                   Authors SHOULD NOT use `aria-valuemin` on any element which allows the `min` attribute. Use the `min` attribute instead.
                 </p>
                 <p>
-                  Authors MUST NOT use `aria-valuemin` on any element which also has a `min` attribute, even if the values of each attribute match.
+                  Authors MUST NOT use `aria-valuemin` on any element which also has a `min` attribute.
                 </p>
               </td>
             </tr>
@@ -3040,7 +3040,7 @@ <h3 id="docconformance-attr">
                   allowed the `readonly` attribute in HTML.
                 </p>
                 <p>
-                  Authors MAY use the `aria-readonly` attribute on any element with a WAI-ARIA role which allows the <a data-cite="wai-aria-1.1#aria-readonly">`aria-readonly` attribute</a>.
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-readonly">`aria-readonly`</a> attribute on any element with a WAI-ARIA role which allows the attribute</a>.
                 </p>
                 <p>
                   Authors SHOULD NOT use the `aria-readonly="true"` on any element which also has a `readonly` attribute.
@@ -3085,7 +3085,7 @@ <h3 id="docconformance-attr">
                   that is allowed the `required` attribute in HTML.
                 </p>
                 <p>
-                  Authors MAY use the `aria-required` attribute on any element that is allowed the `required` attribute in HTML, or any element with a WAI-ARIA role which allows the <a data-cite="wai-aria-1.1#aria-required">`aria-required` attribute</a>.
+                  Authors MAY use the <a data-cite="wai-aria-1.1#aria-required">`aria-required`</a> attribute on any element that is allowed the `required` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-required` attribute.
                 </p>
                 <p>
                   Authors SHOULD NOT use the `aria-required="true"` on any element which also has a `required` attribute.