lighthouse 9.5.0-dev.20220720 → 9.5.0-dev.20220721

package/lighthouse-cli/test/smokehouse/__snapshots__/report-assert-test.js.snap

@@ -14,7 +14,7 @@ exports[`getAssertionReport works (multiple failing) 1`] = `
       {
         \\"id\\": \\"cumulative-layout-shift\\",
         \\"title\\": \\"Cumulative Layout Shift\\",
-        \\"description\\": \\"Cumulative Layout Shift measures the movement of visible elements within the viewport. [Learn more](https://web.dev/cls/).\\",
+        \\"description\\": \\"Cumulative Layout Shift measures the movement of visible elements within the viewport. [Learn more about the Cumulative Layout Shift metric](https://web.dev/cls/).\\",
         \\"score\\": 0.8,
         \\"scoreDisplayMode\\": \\"numeric\\",
         \\"numericValue\\": 0.13570762803819444,
@@ -41,7 +41,7 @@ exports[`getAssertionReport works (trivial failing) 1`] = `
       {
         \\"id\\": \\"cumulative-layout-shift\\",
         \\"title\\": \\"Cumulative Layout Shift\\",
-        \\"description\\": \\"Cumulative Layout Shift measures the movement of visible elements within the viewport. [Learn more](https://web.dev/cls/).\\",
+        \\"description\\": \\"Cumulative Layout Shift measures the movement of visible elements within the viewport. [Learn more about the Cumulative Layout Shift metric](https://web.dev/cls/).\\",
         \\"score\\": 0.8,
         \\"scoreDisplayMode\\": \\"numeric\\",
         \\"numericValue\\": 0.13570762803819444,

package/lighthouse-core/audits/accessibility/accesskeys.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Access keys let users quickly focus a part of the page. For proper ' +
       'navigation, each access key must be unique. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/accesskeys).',
+      '[Learn more about access keys](https://dequeuniversity.com/rules/axe/4.4/accesskeys).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-allowed-attr.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Each ARIA `role` supports a specific subset of `aria-*` attributes. ' +
       'Mismatching these invalidates the `aria-*` attributes. [Learn ' +
-      'more](https://dequeuniversity.com/rules/axe/4.4/aria-allowed-attr).',
+      'how to match ARIA attributes to their roles](https://dequeuniversity.com/rules/axe/4.4/aria-allowed-attr).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-command-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accessibility audit that evaluates if important HTML elements do not have accessible names. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: '`button`, `link`, and `menuitem` elements do not have accessible names.',
   /** Description of a Lighthouse audit that tells the user *why* they should have accessible names for HTML elements. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-command-name).',
+  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn how to make command elements more accessible](https://dequeuniversity.com/rules/axe/4.4/aria-command-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-hidden-body.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks if the html <body> element does not have an aria-hidden attribute set on it. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: '`[aria-hidden="true"]` is present on the document `<body>`',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Assistive technologies, like screen readers, work inconsistently when `aria-hidden="true"` is set on the document `<body>`. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-hidden-body).',
+  description: 'Assistive technologies, like screen readers, work inconsistently when `aria-hidden="true"` is set on the document `<body>`. [Learn how `aria-hidden` affects the document body](https://dequeuniversity.com/rules/axe/4.4/aria-hidden-body).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-hidden-focus.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks if all elements that have an aria-hidden attribute do not contain focusable descendent elements. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: '`[aria-hidden="true"]` elements contain focusable descendents',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Focusable descendents within an `[aria-hidden="true"]` element prevent those interactive elements from being available to users of assistive technologies like screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-hidden-focus).',
+  description: 'Focusable descendents within an `[aria-hidden="true"]` element prevent those interactive elements from being available to users of assistive technologies like screen readers. [Learn how `aria-hidden` affects focusable elements](https://dequeuniversity.com/rules/axe/4.4/aria-hidden-focus).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-input-field-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks that all ARIA input fields have an accessible name. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA input fields do not have accessible names',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When an input field doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-input-field-name).',
+  description: 'When an input field doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more about input field labels](https://dequeuniversity.com/rules/axe/4.4/aria-input-field-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-meter-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accessibility audit that evaluates if meter HTML elements do not have accessible names. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA `meter` elements do not have accessible names.',
   /** Description of a Lighthouse audit that tells the user *why* they should have accessible names for HTML elements. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-meter-name).',
+  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn how to name `meter` elements](https://dequeuniversity.com/rules/axe/4.4/aria-meter-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-progressbar-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accessibility audit that evaluates if progressbar HTML elements do not have accessible names. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA `progressbar` elements do not have accessible names.',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When a `progressbar` element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-progressbar-name).',
+  description: 'When a `progressbar` element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn how to label `progressbar` elements](https://dequeuniversity.com/rules/axe/4.4/aria-progressbar-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-required-attr.js

@@ -21,7 +21,7 @@ const UIStrings = {
   failureTitle: '`[role]`s do not have all required `[aria-*]` attributes',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Some ARIA roles have required attributes that describe the state ' +
-      'of the element to screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-required-attr).',
+      'of the element to screen readers. [Learn more about roles and required attributes](https://dequeuniversity.com/rules/axe/4.4/aria-required-attr).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-required-children.js

@@ -25,7 +25,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Some ARIA parent roles must contain specific child roles to perform ' +
       'their intended accessibility functions. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-required-children).',
+      '[Learn more about roles and required children elements](https://dequeuniversity.com/rules/axe/4.4/aria-required-children).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-required-parent.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Some ARIA child roles must be contained by specific parent roles to ' +
       'properly perform their intended accessibility functions. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-required-parent).',
+      '[Learn more about ARIA roles and required parent element](https://dequeuniversity.com/rules/axe/4.4/aria-required-parent).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-roles.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'ARIA roles must have valid values in order to perform their ' +
       'intended accessibility functions. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-roles).',
+      '[Learn more about valid ARIA roles](https://dequeuniversity.com/rules/axe/4.4/aria-roles).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-toggle-field-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks that all ARIA toggle fields have an accessible name. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA toggle fields do not have accessible names',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When a toggle field doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-toggle-field-name).',
+  description: 'When a toggle field doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more about toggle fields](https://dequeuniversity.com/rules/axe/4.4/aria-toggle-field-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-tooltip-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accessibility audit that evaluates if tooltip HTML elements do not have accessible names. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA `tooltip` elements do not have accessible names.',
   /** Description of a Lighthouse audit that tells the user *why* they should have accessible names for HTML elements. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-tooltip-name).',
+  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn how to name `tooltip` elements](https://dequeuniversity.com/rules/axe/4.4/aria-tooltip-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-treeitem-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accessibility audit that evaluates if treeitem HTML elements do not have accessible names. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA `treeitem` elements do not have accessible names.',
   /** Description of a Lighthouse audit that tells the user *why* they should have accessible names for HTML elements. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'When an element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more](https://dequeuniversity.com/rules/axe/4.4/aria-treeitem-name).',
+  description: 'When a `treeitem` element doesn\'t have an accessible name, screen readers announce it with a generic name, making it unusable for users who rely on screen readers. [Learn more about labeling `treeitem` elements](https://dequeuniversity.com/rules/axe/4.4/aria-treeitem-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-valid-attr-value.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Assistive technologies, like screen readers, can\'t interpret ARIA ' +
       'attributes with invalid values. [Learn ' +
-      'more](https://dequeuniversity.com/rules/axe/4.4/aria-valid-attr-value).',
+      'more about valid values for ARIA attributes](https://dequeuniversity.com/rules/axe/4.4/aria-valid-attr-value).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/aria-valid-attr.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Assistive technologies, like screen readers, can\'t interpret ARIA ' +
       'attributes with invalid names. [Learn ' +
-      'more](https://dequeuniversity.com/rules/axe/4.4/aria-valid-attr).',
+      'more about valid ARIA attributes](https://dequeuniversity.com/rules/axe/4.4/aria-valid-attr).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/button-name.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'When a button doesn\'t have an accessible name, screen readers announce it ' +
       'as "button", making it unusable for users who rely on screen readers. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/button-name).',
+      '[Learn how to make buttons more accessible](https://dequeuniversity.com/rules/axe/4.4/button-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/bypass.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Adding ways to bypass repetitive content lets keyboard users navigate the ' +
       'page more efficiently. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/bypass).',
+      '[Learn more about bypass blocks](https://dequeuniversity.com/rules/axe/4.4/bypass).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/color-contrast.js

@@ -23,7 +23,7 @@ const UIStrings = {
       'sufficient contrast ratio.',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Low-contrast text is difficult or impossible for many users to read. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/color-contrast).',
+      '[Learn how to provide sufficient color contrast](https://dequeuniversity.com/rules/axe/4.4/color-contrast).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/definition-list.js

@@ -24,7 +24,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'When definition lists are not properly marked up, screen readers may produce ' +
       'confusing or inaccurate output. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/definition-list).',
+      '[Learn how to structure definition lists correctly](https://dequeuniversity.com/rules/axe/4.4/definition-list).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/dlitem.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Definition list items (`<dt>` and `<dd>`) must be wrapped in a ' +
       'parent `<dl>` element to ensure that screen readers can properly announce them. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/dlitem).',
+      '[Learn how to structure definition lists correctly](https://dequeuniversity.com/rules/axe/4.4/dlitem).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/document-title.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'The title gives screen reader users an overview of the page, and search ' +
       'engine users rely on it heavily to determine if a page is relevant to their search. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/document-title).',
+      '[Learn more about document titles](https://dequeuniversity.com/rules/axe/4.4/document-title).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/duplicate-id-active.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks if there are any duplicate id HTML attributes on active, focusable elements. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: '`[id]` attributes on active, focusable elements are not unique',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'All focusable elements must have a unique `id` to ensure that they\'re visible to assistive technologies. [Learn more](https://dequeuniversity.com/rules/axe/4.4/duplicate-id-active).',
+  description: 'All focusable elements must have a unique `id` to ensure that they\'re visible to assistive technologies. [Learn how to fix duplicate `id`s](https://dequeuniversity.com/rules/axe/4.4/duplicate-id-active).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/duplicate-id-aria.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks if there are any duplicate ARIA IDs on the page. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'ARIA IDs are not unique',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'The value of an ARIA ID must be unique to prevent other instances from being overlooked by assistive technologies. [Learn more](https://dequeuniversity.com/rules/axe/4.4/duplicate-id-aria).',
+  description: 'The value of an ARIA ID must be unique to prevent other instances from being overlooked by assistive technologies. [Learn how to fix duplicate ARIA IDs](https://dequeuniversity.com/rules/axe/4.4/duplicate-id-aria).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/form-field-multiple-labels.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks if any form fields have multiple label elements. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'Form fields have multiple labels',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Form fields with multiple labels can be confusingly announced by assistive technologies like screen readers which use either the first, the last, or all of the labels. [Learn more](https://dequeuniversity.com/rules/axe/4.4/form-field-multiple-labels).',
+  description: 'Form fields with multiple labels can be confusingly announced by assistive technologies like screen readers which use either the first, the last, or all of the labels. [Learn how to use form labels](https://dequeuniversity.com/rules/axe/4.4/form-field-multiple-labels).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/frame-title.js

@@ -21,7 +21,7 @@ const UIStrings = {
   failureTitle: '`<frame>` or `<iframe>` elements do not have a title',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Screen reader users rely on frame titles to describe the contents of frames. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/frame-title).',
+      '[Learn more about frame titles](https://dequeuniversity.com/rules/axe/4.4/frame-title).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/heading-order.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of an accesibility audit that checks if heading elements (<h1>, <h2>, etc) appear in numeric order and only ever increase in steps of 1. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'Heading elements are not in a sequentially-descending order',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Properly ordered headings that do not skip levels convey the semantic structure of the page, making it easier to navigate and understand when using assistive technologies. [Learn more](https://dequeuniversity.com/rules/axe/4.4/heading-order).',
+  description: 'Properly ordered headings that do not skip levels convey the semantic structure of the page, making it easier to navigate and understand when using assistive technologies. [Learn more about heading order](https://dequeuniversity.com/rules/axe/4.4/heading-order).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/html-has-lang.js

@@ -20,11 +20,11 @@ const UIStrings = {
   /** Title of an accesibility audit that evaluates if the root HTML tag has a lang attribute identifying the page's language. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: '`<html>` element does not have a `[lang]` attribute',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'If a page doesn\'t specify a lang attribute, a screen reader assumes ' +
+  description: 'If a page doesn\'t specify a `lang` attribute, a screen reader assumes ' +
       'that the page is in the default language that the user chose when setting up the ' +
       'screen reader. If the page isn\'t actually in the default language, then the screen ' +
       'reader might not announce the page\'s text correctly. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/html-has-lang).',
+      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.4/html-has-lang).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/html-lang-valid.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
       'helps screen readers announce text properly. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/html-lang-valid).',
+      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.4/html-lang-valid).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/image-alt.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Informative elements should aim for short, descriptive alternate text. ' +
       'Decorative elements can be ignored with an empty alt attribute. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/image-alt).',
+      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.4/image-alt).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/input-image-alt.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'When an image is being used as an `<input>` button, providing alternative ' +
       'text can help screen reader users understand the purpose of the button. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/input-image-alt).',
+      '[Learn about input image alt text](https://dequeuniversity.com/rules/axe/4.4/input-image-alt).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/label.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Labels ensure that form controls are announced properly by assistive ' +
       'technologies, like screen readers. [Learn ' +
-      'more](https://dequeuniversity.com/rules/axe/4.4/label).',
+      'more about form element labels](https://dequeuniversity.com/rules/axe/4.4/label).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/link-name.js

@@ -23,7 +23,7 @@ const UIStrings = {
   description: 'Link text (and alternate text for images, when used as links) that is ' +
       'discernible, unique, and focusable improves the navigation experience for ' +
       'screen reader users. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/link-name).',
+      '[Learn how to make links accessible](https://dequeuniversity.com/rules/axe/4.4/link-name).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/list.js

@@ -24,7 +24,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Screen readers have a specific way of announcing lists. Ensuring proper list ' +
       'structure aids screen reader output. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/list).',
+      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.4/list).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/listitem.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Screen readers require list items (`<li>`) to be contained within a ' +
       'parent `<ul>`, `<ol>` or `<menu>` to be announced properly. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/listitem).',
+      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.4/listitem).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/manual/custom-controls-labels.js

@@ -19,7 +19,7 @@ class CustomControlsLabels extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'custom-controls-labels',
-      description: 'Custom interactive controls have associated labels, provided by aria-label or aria-labelledby. [Learn more](https://web.dev/custom-controls-labels/).',
+      description: 'Custom interactive controls have associated labels, provided by aria-label or aria-labelledby. [Learn more about custom controls and labels](https://web.dev/custom-controls-labels/).',
       title: 'Custom controls have associated labels',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/custom-controls-roles.js

@@ -19,7 +19,7 @@ class CustomControlsRoles extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'custom-controls-roles',
-      description: 'Custom interactive controls have appropriate ARIA roles. [Learn more](https://web.dev/custom-control-roles/).',
+      description: 'Custom interactive controls have appropriate ARIA roles. [Learn how to add roles to custom controls](https://web.dev/custom-control-roles/).',
       title: 'Custom controls have ARIA roles',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/focus-traps.js

@@ -19,7 +19,7 @@ class FocusTraps extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'focus-traps',
-      description: 'A user can tab into and out of any control or region without accidentally trapping their focus. [Learn more](https://web.dev/focus-traps/).',
+      description: 'A user can tab into and out of any control or region without accidentally trapping their focus. [Learn how to avoid focus traps](https://web.dev/focus-traps/).',
       title: 'User focus is not accidentally trapped in a region',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/focusable-controls.js

@@ -19,7 +19,7 @@ class FocusableControls extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'focusable-controls',
-      description: 'Custom interactive controls are keyboard focusable and display a focus indicator. [Learn more](https://web.dev/focusable-controls/).',
+      description: 'Custom interactive controls are keyboard focusable and display a focus indicator. [Learn how to make custom controls focusable](https://web.dev/focusable-controls/).',
       title: 'Interactive controls are keyboard focusable',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/interactive-element-affordance.js

@@ -19,7 +19,7 @@ class InteractiveElementAffordance extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'interactive-element-affordance',
-      description: 'Interactive elements, such as links and buttons, should indicate their state and be distinguishable from non-interactive elements. [Learn more](https://web.dev/interactive-element-affordance/).',
+      description: 'Interactive elements, such as links and buttons, should indicate their state and be distinguishable from non-interactive elements. [Learn how to decorate interactive elements with affordance hints](https://web.dev/interactive-element-affordance/).',
       title: 'Interactive elements indicate their purpose and state',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/logical-tab-order.js

@@ -19,7 +19,7 @@ class LogicalTabOrder extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'logical-tab-order',
-      description: 'Tabbing through the page follows the visual layout. Users cannot focus elements that are offscreen. [Learn more](https://web.dev/logical-tab-order/).',
+      description: 'Tabbing through the page follows the visual layout. Users cannot focus elements that are offscreen. [Learn more about logical tab ordering](https://web.dev/logical-tab-order/).',
       title: 'The page has a logical tab order',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/managed-focus.js

@@ -19,7 +19,7 @@ class ManagedFocus extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'managed-focus',
-      description: 'If new content, such as a dialog, is added to the page, the user\'s focus is directed to it. [Learn more](https://web.dev/managed-focus/).',
+      description: 'If new content, such as a dialog, is added to the page, the user\'s focus is directed to it. [Learn how to direct focus to new content](https://web.dev/managed-focus/).',
       title: 'The user\'s focus is directed to new content added to the page',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/offscreen-content-hidden.js

@@ -20,7 +20,7 @@ class OffscreenContentHidden extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'offscreen-content-hidden',
-      description: 'Offscreen content is hidden with display: none or aria-hidden=true. [Learn more](https://web.dev/offscreen-content-hidden/).',
+      description: 'Offscreen content is hidden with display: none or aria-hidden=true. [Learn how to properly hide offscreen content](https://web.dev/offscreen-content-hidden/).',
       title: 'Offscreen content is hidden from assistive technology',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/use-landmarks.js

@@ -19,7 +19,7 @@ class UseLandmarks extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'use-landmarks',
-      description: 'Landmark elements (<main>, <nav>, etc.) are used to improve the keyboard navigation of the page for assistive technology. [Learn more](https://web.dev/use-landmarks/).',
+      description: 'Landmark elements (<main>, <nav>, etc.) are used to improve the keyboard navigation of the page for assistive technology. [Learn more about landmark elements](https://web.dev/use-landmarks/).',
       title: 'HTML5 landmark elements are used to improve navigation',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/manual/visual-order-follows-dom.js

@@ -19,7 +19,7 @@ class VisualOrderFollowsDOM extends ManualAudit {
   static get meta() {
     return Object.assign({
       id: 'visual-order-follows-dom',
-      description: 'DOM order matches the visual order, improving navigation for assistive technology. [Learn more](https://web.dev/visual-order-follows-dom/).',
+      description: 'DOM order matches the visual order, improving navigation for assistive technology. [Learn more about DOM and visual ordering](https://web.dev/visual-order-follows-dom/).',
       title: 'Visual order on the page follows DOM order',
     }, super.partialMeta);
   }

package/lighthouse-core/audits/accessibility/meta-refresh.js

@@ -23,7 +23,7 @@ const UIStrings = {
   description: 'Users do not expect a page to refresh automatically, and doing so will move ' +
       'focus back to the top of the page. This may create a frustrating or ' +
       'confusing experience. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/meta-refresh).',
+      '[Learn more about the refresh meta tag](https://dequeuniversity.com/rules/axe/4.4/meta-refresh).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/meta-viewport.js

@@ -24,7 +24,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Disabling zooming is problematic for users with low vision who rely on ' +
       'screen magnification to properly see the contents of a web page. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/meta-viewport).',
+      '[Learn more about the viewport meta tag](https://dequeuniversity.com/rules/axe/4.4/meta-viewport).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/object-alt.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Screen readers cannot translate non-text content. Adding alternate text to ' +
       '`<object>` elements helps screen readers convey meaning to users. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/object-alt).',
+      '[Learn more about alt text for `object` elements](https://dequeuniversity.com/rules/axe/4.4/object-alt).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/tabindex.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'A value greater than 0 implies an explicit navigation ordering. ' +
       'Although technically valid, this often creates frustrating experiences ' +
-      'for users who rely on assistive technologies. [Learn more](https://dequeuniversity.com/rules/axe/4.4/tabindex).',
+      'for users who rely on assistive technologies. [Learn more about the `tabindex` attribute](https://dequeuniversity.com/rules/axe/4.4/tabindex).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/td-headers-attr.js

@@ -26,7 +26,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       '`<td>` cells using the `[headers]` attribute only refer to other cells in the same ' +
       'table may improve the experience for screen reader users. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/td-headers-attr).',
+      '[Learn more about the `headers` attribute](https://dequeuniversity.com/rules/axe/4.4/td-headers-attr).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/accessibility/th-has-data-cells.js

@@ -25,7 +25,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'table headers always refer to some set of cells may improve the experience for screen ' +
       'reader users. ' +
-      '[Learn more](https://dequeuniversity.com/rules/axe/4.4/th-has-data-cells).',
+      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.4/th-has-data-cells).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);