Editorials to 'audio has alternative' rules (#1808)

* Editorials to 'audio has alternative' rules * Update _rules/audio-text-alternative-e7aa44.md Co-authored-by: Kathy Eng <kengdoj@users.noreply.github.com> Co-authored-by: Kathy Eng <kengdoj@users.noreply.github.com> Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com>
act-rules · Apr 5, 2022 · 73716a2 · 73716a2
1 parent 25d868f
commit 73716a2
Show file tree

Hide file tree

Showing 3 changed files with 27 additions and 27 deletions.
diff --git a/_rules/audio-as-media-alternative-afb423.md b/_rules/audio-as-media-alternative-afb423.md
@@ -3,7 +3,7 @@ id: afb423
 name: '`audio` element content is media alternative for text'
 rule_type: atomic
 description: |
-  This rule checks `audio` is a media alternative for text on the page.
+  This rule checks that the `audio` element is a media alternative for text on the page.
 accessibility_requirements:
 input_aspects:
   - DOM Tree
@@ -59,7 +59,7 @@ There are no major accessibility support issues known for this rule.
 
 #### Passed Example 1
 
-An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative.
+This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative.
 
 ```html
 <html lang="en">
@@ -80,7 +80,7 @@ An audio element that describes some of the text on the same page. The text on t
 
 #### Failed Example 1
 
-An audio element that describes some of the text on the same page. The audio contains more information than the text does.
+This `audio` element describes some of the text on the same page. The audio contains more information than the text does.
 
 ```html
 <html lang="en">
@@ -97,7 +97,7 @@ An audio element that describes some of the text on the same page. The audio con
 
 #### Failed Example 2
 
-An audio element that describes some of the text on the same page. The text is not [visible][] on the page.
+This `audio` element describes some of the text on the same page. The text is not [visible][] on the page.
 
 ```html
 <html lang="en">
@@ -116,7 +116,7 @@ An audio element that describes some of the text on the same page. The text is n
 
 #### Failed Example 3
 
-An audio element that describes some of the text on the same page. The text on the page does not label the audio as an alternative.
+This `audio` element describes some of the text on the same page. The text on the page does not label the audio as an alternative.
 
 ```html
 <html lang="en">
@@ -132,7 +132,7 @@ An audio element that describes some of the text on the same page. The text on t
 
 #### Failed Example 4
 
-An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but the label is not [visible][] on the page.
+This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but the label is not [visible][] on the page.
 
 ```html
 <html lang="en">
@@ -153,7 +153,7 @@ An audio element that describes some of the text on the same page. The text on t
 
 #### Inapplicable Example 1
 
-An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.
+This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.
 
 ```html
 <html lang="en">
@@ -172,7 +172,7 @@ An audio element that describes some of the text on the same page. The text on t
 
 #### Inapplicable Example 2
 
-An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but there are no controls.
+This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but there are no controls.
 
 ```html
 <html lang="en">

diff --git a/_rules/audio-text-alternative-e7aa44.md b/_rules/audio-text-alternative-e7aa44.md
@@ -3,7 +3,7 @@ id: e7aa44
 name: '`audio` element content has text alternative'
 rule_type: composite
 description: |
-  This rule checks if audio only elements have a text alternative available.
+  This rule checks that `audio` elements have a text alternative available.
 accessibility_requirements:
   wcag20:1.2.1: # Audio-only and Video-only (Prerecorded) (A)
     forConformance: true
@@ -67,7 +67,7 @@ There are no major accessibility support issues known for this rule.
 
 #### Passed Example 1
 
-Audio with controls and internal transcript
+This `audio` element has native player controls and an internal transcript.
 
 ```html
 <html lang="en">
@@ -83,7 +83,7 @@ Audio with controls and internal transcript
 
 #### Passed Example 2
 
-An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative.
+This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative.
 
 ```html
 <html lang="en">
@@ -104,7 +104,7 @@ An audio element that describes some of the text on the same page. The text on t
 
 #### Failed Example 1
 
-Audio with controls and incorrect internal transcript
+This `audio` element has native player controls but has an incorrect internal transcript.
 
 ```html
 <html lang="en">
@@ -120,7 +120,7 @@ Audio with controls and incorrect internal transcript
 
 #### Failed Example 2
 
-An audio element that describes some of the text on the same page. The text is not [visible][] on the page.
+This `audio` element describes some of the text on the same page. The text is not [visible][] on the page.
 
 ```html
 <html lang="en">
@@ -141,7 +141,7 @@ An audio element that describes some of the text on the same page. The text is n
 
 #### Inapplicable Example 1
 
-Audio without controls.
+This `audio` element does not have native player controls.
 
 ```html
 <html lang="en">
@@ -151,7 +151,7 @@ Audio without controls.
 
 #### Inapplicable Example 2
 
-An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.
+This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.
 
 ```html
 <html lang="en">

diff --git a/_rules/audio-transcript-2eb176.md b/_rules/audio-transcript-2eb176.md
@@ -3,7 +3,7 @@ id: 2eb176
 name: '`audio` element content has transcript'
 rule_type: atomic
 description: |
-  Non-streaming `audio` elements must have a text alternative for all included auditory information.
+  This rule checks that `audio` elements have a transcript that includes all auditory information.
 accessibility_requirements:
 input_aspects:
   - DOM Tree
@@ -56,7 +56,7 @@ There are no major accessibility support issues known for this rule.
 
 #### Passed Example 1
 
-Audio with controls and internal transcript
+This `audio` element has native player controls and an internal transcript.
 
 ```html
 <html lang="en">
@@ -72,7 +72,7 @@ Audio with controls and internal transcript
 
 #### Passed Example 2
 
-Audio with controls and external transcript
+This `audio` element has native player controls and an external transcript.
 
 ```html
 <html lang="en">
@@ -83,7 +83,7 @@ Audio with controls and external transcript
 
 #### Passed Example 3
 
-Audio with autoplay and external transcript
+This `audio` element has an `autoplay` attribute and an external transcript.
 
 ```html
 <html lang="en">
@@ -96,7 +96,7 @@ Audio with autoplay and external transcript
 
 #### Failed Example 1
 
-Audio with controls and no transcript
+This `audio` element has native player controls and no transcript.
 
 ```html
 <html lang="en">
@@ -106,7 +106,7 @@ Audio with controls and no transcript
 
 #### Failed Example 2
 
-Audio with controls and incorrect internal transcript
+This `audio` element has native player controls and an incorrect internal transcript.
 
 ```html
 <html lang="en">
@@ -122,7 +122,7 @@ Audio with controls and incorrect internal transcript
 
 #### Failed Example 3
 
-Audio with controls and incorrect external transcript
+This `audio` element has native player controls and an incorrect external transcript.
 
 ```html
 <html lang="en">
@@ -133,7 +133,7 @@ Audio with controls and incorrect external transcript
 
 #### Failed Example 4
 
-Audio with autoplay and incorrect external transcript
+This `audio` element has an `autoplay` attribute and an incorrect external transcript.
 
 ```html
 <html lang="en">
@@ -144,7 +144,7 @@ Audio with autoplay and incorrect external transcript
 
 #### Failed Example 5
 
-Audio with controls and [non-visible][visible] internal transcript
+This `audio` element has native player controls and a [non-visible][visible] internal transcript.
 
 ```html
 <html lang="en">
@@ -160,7 +160,7 @@ Audio with controls and [non-visible][visible] internal transcript
 
 #### Failed Example 6
 
-Audio with controls and internal transcript that is not exposed to the accessibility tree
+This `audio` element has native player controls and an internal transcript that is not exposed to the accessibility tree.
 
 ```html
 <html lang="en">
@@ -178,7 +178,7 @@ Audio with controls and internal transcript that is not exposed to the accessibi
 
 #### Inapplicable Example 1
 
-Audio without controls.
+This `audio` element has no native player controls.
 
 ```html
 <html lang="en">
@@ -188,7 +188,7 @@ Audio without controls.
 
 #### Inapplicable Example 2
 
-Audio with hidden controls.
+This `audio` element has hidden native player controls.
 
 ```html
 <html lang="en">