lighthouse 9.5.0-dev.20220718 → 9.5.0-dev.20220721

package/lighthouse-core/audits/metrics/experimental-interaction-to-next-paint.js

@@ -12,7 +12,8 @@ import * as i18n from '../../lib/i18n/i18n.js';
 const UIStrings = {
   /** Description of the Interaction to Next Paint metric. This description is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Interaction to Next Paint measures page responsiveness, how long it ' +
-               'takes the page to visibly respond to user input. [Learn more](https://web.dev/inp/).',
+               'takes the page to visibly respond to user input. ' +
+               '[Learn more about the Interaction to Next Paint metric](https://web.dev/inp/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/first-contentful-paint-3g.js

@@ -20,7 +20,8 @@ class FirstContentfulPaint3G extends Audit {
       id: 'first-contentful-paint-3g',
       title: 'First Contentful Paint (3G)',
       description: 'First Contentful Paint 3G marks the time at which the first text or image is ' +
-        `painted while on a 3G network. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/first-contentful-paint).`,
+        'painted while on a 3G network. ' +
+        '[Learn more about the First Contentful Paint (3G) metric](https://developers.google.com/web/tools/lighthouse/audits/first-contentful-paint).',
       scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
       supportedModes: ['navigation'],
       requiredArtifacts: ['traces', 'devtoolsLogs', 'GatherContext', 'URL'],

package/lighthouse-core/audits/metrics/first-contentful-paint.js

@@ -12,7 +12,7 @@ import ComputedFcp from '../../computed/metrics/first-contentful-paint.js';
 const UIStrings = {
   /** Description of the First Contentful Paint (FCP) metric, which marks the time at which the first text or image is painted by the browser. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'First Contentful Paint marks the time at which the first text or image is ' +
-      `painted. [Learn more](https://web.dev/first-contentful-paint/).`,
+      'painted. [Learn more about the First Contentful Paint metric](https://web.dev/first-contentful-paint/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/first-meaningful-paint.js

@@ -12,7 +12,7 @@ import ComputedFmp from '../../computed/metrics/first-meaningful-paint.js';
 const UIStrings = {
   /** Description of the First Meaningful Paint (FMP) metric, which marks the time at which a majority of the content has been painted by the browser. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'First Meaningful Paint measures when the primary content of a page is ' +
-      'visible. [Learn more](https://web.dev/first-meaningful-paint/).',
+      'visible. [Learn more about the First Meaningful Paint metric](https://web.dev/first-meaningful-paint/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/interactive.js

@@ -11,8 +11,8 @@ import Interactive from '../../computed/metrics/interactive.js';
 
 const UIStrings = {
   /** Description of the Time to Interactive (TTI) metric, which evaluates when a page has completed its primary network activity and main thread work. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Time to interactive is the amount of time it takes for the page to become fully ' +
-    'interactive. [Learn more](https://web.dev/interactive/).',
+  description: 'Time to Interactive is the amount of time it takes for the page to become fully ' +
+    'interactive. [Learn more about the Time to Interactive metric](https://web.dev/interactive/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/largest-contentful-paint.js

@@ -12,7 +12,7 @@ import ComputedLcp from '../../computed/metrics/largest-contentful-paint.js';
 const UIStrings = {
   /** Description of the Largest Contentful Paint (LCP) metric, which marks the time at which the largest text or image is painted by the browser. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Largest Contentful Paint marks the time at which the largest text or image is ' +
-      `painted. [Learn more](https://web.dev/lighthouse-largest-contentful-paint/)`,
+      `painted. [Learn more about the Largest Contentful Paint metric](https://web.dev/lighthouse-largest-contentful-paint/)`,
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/max-potential-fid.js

@@ -12,7 +12,8 @@ import * as i18n from '../../lib/i18n/i18n.js';
 const UIStrings = {
   /** Description of the Maximum Potential First Input Delay metric that marks the maximum estimated time between the page receiving input (a user clicking, tapping, or typing) and the page responding. This description is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'The maximum potential First Input Delay that your users could experience is the ' +
-      'duration of the longest task. [Learn more](https://web.dev/lighthouse-max-potential-fid/).',
+      'duration of the longest task. ' +
+      '[Learn more about the Maximum Potential First Input Delay metric](https://web.dev/lighthouse-max-potential-fid/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/speed-index.js

@@ -12,7 +12,7 @@ import ComputedSi from '../../computed/metrics/speed-index.js';
 const UIStrings = {
   /** Description of the Speed Index metric, which summarizes how quickly the page looked visually complete. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Speed Index shows how quickly the contents of a page are visibly populated. ' +
-      '[Learn more](https://web.dev/speed-index/).',
+      '[Learn more about the Speed Index metric](https://web.dev/speed-index/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/metrics/total-blocking-time.js

@@ -12,7 +12,8 @@ import * as i18n from '../../lib/i18n/i18n.js';
 const UIStrings = {
   /** Description of the Total Blocking Time (TBT) metric, which calculates the total duration of blocking time for a web page. Blocking times are time periods when the page would be blocked (prevented) from responding to user input (clicks, taps, and keypresses will feel slow to respond). This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits.*/
   description: 'Sum of all time periods between FCP and Time to Interactive, ' +
-      'when task length exceeded 50ms, expressed in milliseconds. [Learn more](https://web.dev/lighthouse-total-blocking-time/).',
+      'when task length exceeded 50ms, expressed in milliseconds. ' +
+      '[Learn more about the Total Blocking Time metric](https://web.dev/lighthouse-total-blocking-time/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/network-rtt.js

@@ -16,7 +16,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user that a high network round trip time (RTT) can effect their website's performance because the server is physically far away from them thus making the RTT high. 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: 'Network round trip times (RTT) have a large impact on performance. ' +
     'If the RTT to an origin is high, it\'s an indication that servers closer to the user could ' +
-    'improve performance. [Learn more](https://hpbn.co/primer-on-latency-and-bandwidth/).',
+    'improve performance. [Learn more about the Round Trip Time](https://hpbn.co/primer-on-latency-and-bandwidth/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/network-server-latency.js

@@ -16,7 +16,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user that server latency can effect their website's performance negatively. 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: 'Server latencies can impact web performance. ' +
     'If the server latency of an origin is high, it\'s an indication the server is overloaded ' +
-    'or has poor backend performance. [Learn more](https://hpbn.co/primer-on-web-performance/#analyzing-the-resource-waterfall).',
+    'or has poor backend performance. [Learn more about server response time](https://hpbn.co/primer-on-web-performance/#analyzing-the-resource-waterfall).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/no-unload-listeners.js

@@ -15,7 +15,7 @@ const UIStrings = {
   /** Descriptive title of a Lighthouse audit that checks if a web page has 'unload' event listeners and finds that it is using them. */
   failureTitle: 'Registers an `unload` listener',
   /** Description of a Lighthouse audit that tells the user why pages should not use the 'unload' event. This is displayed after a user expands the section to see more. 'Learn More' becomes link text to additional documentation. */
-  description: 'The `unload` event does not fire reliably and listening for it can prevent browser optimizations like the Back-Forward Cache. Use `pagehide` or `visibilitychange` events instead. [Learn more](https://web.dev/bfcache/#never-use-the-unload-event)',
+  description: 'The `unload` event does not fire reliably and listening for it can prevent browser optimizations like the Back-Forward Cache. Use `pagehide` or `visibilitychange` events instead. [Learn more about unload event listeners](https://web.dev/bfcache/#never-use-the-unload-event)',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/non-composited-animations.js

@@ -20,7 +20,7 @@ const UIStrings = {
   title: 'Avoid non-composited animations',
   /** Description of a diagnostic LH audit that shows the user animations that are not composited. Janky means frames may be skipped and the animation will look bad. Acceptable alternatives here might be 'poor', or 'slow'. */
   description: 'Animations which are not composited can be janky and increase CLS. ' +
-    '[Learn more](https://web.dev/non-composited-animations)',
+    '[Learn how to avoid non-composited animations](https://web.dev/non-composited-animations)',
   /** [ICU Syntax] Label identifying the number of animated elements that are not composited. */
   displayValue: `{itemCount, plural,
   =1 {# animated element found}

package/lighthouse-core/audits/performance-budget.js

@@ -16,7 +16,8 @@ const UIStrings = {
   title: 'Performance budget',
   /** Description of a Lighthouse audit where a user sets budgets for the quantity and size of page resources. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'Keep the quantity and size of network requests under the targets ' +
-    'set by the provided performance budget. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/budgets).',
+    'set by the provided performance budget. ' +
+    '[Learn more about performance budgets](https://developers.google.com/web/tools/lighthouse/audits/budgets).',
   /** [ICU Syntax] Entry in a data table identifying the number of network requests of a particular type. Count will be a whole number. String should be as short as possible to be able to fit well into the table. */
   requestCountOverBudget: `{count, plural,
     =1 {1 request}

package/lighthouse-core/audits/preload-fonts.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Title of a Lighthouse audit that provides detail on whether fonts that used `font-display: optional` were preloaded. This descriptive title is shown to users when one or more fonts used `font-display: optional` and were not preloaded. */
   failureTitle: 'Fonts with `font-display: optional` are not preloaded',
   /** Description of a Lighthouse audit that tells the user why they should preload fonts if they are using `font-display: optional`. 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: 'Preload `optional` fonts so first-time visitors may use them. [Learn more](https://web.dev/preload-optional-fonts/)',
+  description: 'Preload `optional` fonts so first-time visitors may use them. [Learn more about preloading fonts](https://web.dev/preload-optional-fonts/)',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/preload-lcp-image.js

@@ -18,7 +18,7 @@ const UIStrings = {
   title: 'Preload Largest Contentful Paint image',
   /** Description of a lighthouse audit that tells a user to preload an image in order to improve their LCP time.  */
   description: 'If the LCP element is dynamically added to the page, you should preload the ' +
-    'image in order to improve LCP. [Learn more](https://web.dev/optimize-lcp/#preload-important-resources).',
+    'image in order to improve LCP. [Learn more about preloading LCP elements](https://web.dev/optimize-lcp/#preload-important-resources).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/redirects.js

@@ -17,7 +17,7 @@ const UIStrings = {
   /** Imperative title of a Lighthouse audit that tells the user to eliminate the redirects taken through multiple URLs to load the page. This is shown in a list of audits that Lighthouse generates. */
   title: 'Avoid multiple page redirects',
   /** Description of a Lighthouse audit that tells users why they should reduce the number of server-side redirects on their page. 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: 'Redirects introduce additional delays before the page can be loaded. [Learn more](https://web.dev/redirects/).',
+  description: 'Redirects introduce additional delays before the page can be loaded. [Learn how to avoid page redirects](https://web.dev/redirects/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/resource-summary.js

@@ -14,7 +14,8 @@ const UIStrings = {
   title: 'Keep request counts low and transfer sizes small',
   /** Description of a Lighthouse audit that tells the user that they can setup a budgets for the quantity and size of page resources. No character length limits. 'Learn More' becomes link text to additional documentation. */
   description: 'To set budgets for the quantity and size of page resources,' +
-    ' add a budget.json file. [Learn more](https://web.dev/use-lighthouse-for-performance-budgets/).',
+    ' add a budget.json file. ' +
+    '[Learn more about performance budgets](https://web.dev/use-lighthouse-for-performance-budgets/).',
   /** [ICU Syntax] Label for an audit identifying the number of requests and kibibytes used to load the page. */
   displayValue: `{requestCount, plural, ` +
     `=1 {1 request • {byteCount, number, bytes} KiB} ` +

package/lighthouse-core/audits/seo/canonical.js

@@ -17,7 +17,7 @@ const UIStrings = {
   failureTitle: 'Document does not have a valid `rel=canonical`',
   /** Description of a Lighthouse audit that tells the user *why* they need to have a valid rel=canonical link. 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: 'Canonical links suggest which URL to show in search results. ' +
-    '[Learn more](https://web.dev/canonical/).',
+    '[Learn more about canonical links](https://web.dev/canonical/).',
   /**
    * @description Explanatory message stating that there was a failure in an audit caused by multiple URLs conflicting with each other.
    * @example {https://example.com, https://example2.com} urlList

package/lighthouse-core/audits/seo/crawlable-anchors.js

@@ -14,7 +14,7 @@ const UIStrings = {
   /** Descriptive title of a Lighthouse audit that provides detail on whether links have potentially-crawlable href attributes. This descriptive title is shown when there are href attributes which are not crawlable by search engines. */
   failureTitle: 'Links are not crawlable',
   /** Description of a Lighthouse audit that tells the user why href attributes on links should be crawlable. This is displayed after a user expands the section to see more. 'Learn More' becomes link text to additional documentation. */
-  description: 'Search engines may use `href` attributes on links to crawl websites. Ensure that the `href` attribute of anchor elements links to an appropriate destination, so more pages of the site can be discovered. [Learn More](https://support.google.com/webmasters/answer/9112205)',
+  description: 'Search engines may use `href` attributes on links to crawl websites. Ensure that the `href` attribute of anchor elements links to an appropriate destination, so more pages of the site can be discovered. [Learn how to make links crawlable](https://support.google.com/webmasters/answer/9112205)',
   /** Label for a column in a data table; entries will be the HTML anchor elements that failed the audit. Anchors are DOM elements that are links. */
   columnFailingLink: 'Uncrawlable Link',
 };

package/lighthouse-core/audits/seo/font-size.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of a Lighthouse audit that provides detail on the font sizes used on the page. This descriptive title is shown to users when there is a font that may be too small to be read by users. */
   failureTitle: 'Document doesn\'t use legible font sizes',
   /** Description of a Lighthouse audit that tells the user *why* they need to use a larger font size. 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: 'Font sizes less than 12px are too small to be legible and require mobile visitors to “pinch to zoom” in order to read. Strive to have >60% of page text ≥12px. [Learn more](https://web.dev/font-size/).',
+  description: 'Font sizes less than 12px are too small to be legible and require mobile visitors to “pinch to zoom” in order to read. Strive to have >60% of page text ≥12px. [Learn more about legible font sizes](https://web.dev/font-size/).',
   /** Label for the audit identifying font sizes that are too small. */
   displayValue: '{decimalProportion, number, extendedPercent} legible text',
   /** Explanatory message stating that there was a failure in an audit caused by a missing page viewport meta tag configuration. "viewport" and "meta" are HTML terms and should not be translated. */

package/lighthouse-core/audits/seo/hreflang.js

@@ -23,7 +23,7 @@ const UIStrings = {
   failureTitle: 'Document doesn\'t have a valid `hreflang`',
   /** Description of a Lighthouse audit that tells the user *why* they need to have an hreflang link on their page. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. "hreflang" is an HTML attribute and should not be translated. */
   description: 'hreflang links tell search engines what version of a page they should ' +
-    'list in search results for a given language or region. [Learn more]' +
+    'list in search results for a given language or region. [Learn more about `hreflang`]' +
     '(https://web.dev/hreflang/).',
   /** A failure reason for a Lighthouse audit that flags incorrect use of the `hreflang` attribute on `link` elements. This failure reason is shown when the hreflang language code is unexpected. */
   unexpectedLanguage: 'Unexpected language code',

package/lighthouse-core/audits/seo/http-status-code.js

@@ -19,7 +19,7 @@ const UIStrings = {
   failureTitle: 'Page has unsuccessful HTTP status code',
   /** Description of a Lighthouse audit that tells the user *why* they need to serve pages with a valid HTTP status code. 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: 'Pages with unsuccessful HTTP status codes may not be indexed properly. ' +
-  '[Learn more](https://web.dev/http-status-code/).',
+  '[Learn more about HTTP status codes](https://web.dev/http-status-code/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/seo/is-crawlable.js

@@ -27,7 +27,7 @@ const UIStrings = {
   failureTitle: 'Page is blocked from indexing',
   /** Description of a Lighthouse audit that tells the user *why* allowing search-engine crawling of their page is beneficial. 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: 'Search engines are unable to include your pages in search results ' +
-      'if they don\'t have permission to crawl them. [Learn more](https://web.dev/is-crawable/).',
+      'if they don\'t have permission to crawl them. [Learn more about crawler directives](https://web.dev/is-crawable/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/seo/link-text.js

@@ -84,7 +84,7 @@ const UIStrings = {
   failureTitle: 'Links do not have descriptive text',
   /** Description of a Lighthouse audit that tells the user *why* they need to have descriptive text on the links in their page. 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: 'Descriptive link text helps search engines understand your content. ' +
-  '[Learn more](https://web.dev/link-text/).',
+  '[Learn how to make links more accessible](https://web.dev/link-text/).',
   /** [ICU Syntax] Label for the audit identifying the number of links found. "link" here refers to the links in a web page to other web pages. */
   displayValue: `{itemCount, plural,
     =1 {1 link found}

package/lighthouse-core/audits/seo/manual/structured-data.js

@@ -10,7 +10,7 @@ import * as i18n from '../../../lib/i18n/i18n.js';
 
 const UIStrings = {
   /** Description of a Lighthouse audit that provides detail on the structured data in a page. "Structured data" is a standardized data format on a page that helps a search engine categorize and understand its contents. This description is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Run the [Structured Data Testing Tool](https://search.google.com/structured-data/testing-tool/) and the [Structured Data Linter](http://linter.structured-data.org/) to validate structured data. [Learn more](https://web.dev/structured-data/).',
+  description: 'Run the [Structured Data Testing Tool](https://search.google.com/structured-data/testing-tool/) and the [Structured Data Linter](http://linter.structured-data.org/) to validate structured data. [Learn more about Structured Data](https://web.dev/structured-data/).',
   /** Title of a Lighthouse audit that prompts users to manually check their page for valid structured data. "Structured data" is a standardized data format on a page that helps a search engine categorize and understand its contents. */
   title: 'Structured data is valid',
 };

package/lighthouse-core/audits/seo/meta-description.js

@@ -16,7 +16,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they need to have meta descriptions on their page. 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: 'Meta descriptions may be included in search results to concisely summarize ' +
       'page content. ' +
-      '[Learn more](https://web.dev/meta-description/).',
+      '[Learn more about the meta description](https://web.dev/meta-description/).',
   /** Explanatory message stating that there was a failure in an audit caused by the page's meta description text being empty. */
   explanation: 'Description text is empty.',
 };

package/lighthouse-core/audits/seo/plugins.js

@@ -41,7 +41,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they need to avoid using browser plugins in their content. 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: 'Search engines can\'t index plugin content, and ' +
     'many devices restrict plugins or don\'t support them. ' +
-    '[Learn more](https://web.dev/plugins/).',
+    '[Learn more about avoiding plugins](https://web.dev/plugins/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/seo/robots-txt.js

@@ -41,7 +41,8 @@ const UIStrings = {
   failureTitle: 'robots.txt is not valid',
   /** Description of a Lighthouse audit that tells the user *why* they need to have a valid robots.txt file. Note: "robots.txt" is a canonical filename and should not be translated. This is displayed after a user expands the section to see more. No character length limits. */
   description: 'If your robots.txt file is malformed, crawlers may not be able to understand ' +
-  'how you want your website to be crawled or indexed. [Learn more](https://web.dev/robots-txt/).',
+  'how you want your website to be crawled or indexed. ' +
+  '[Learn more about robots.txt](https://web.dev/robots-txt/).',
   /**
    * @description Label for the audit identifying that the robots.txt request has returned a specific HTTP status code. Note: "robots.txt" is a canonical filename and should not be translated.
    * @example {500} statusCode

package/lighthouse-core/audits/seo/tap-targets.js

@@ -31,7 +31,7 @@ const UIStrings = {
   /** Descriptive title of a Lighthouse audit that provides detail on whether tap targets (like buttons and links) on a page are big enough so they can easily be tapped on a mobile device. This descriptive title is shown when tap targets are not easy to tap on. */
   failureTitle: 'Tap targets are not sized appropriately',
   /** Description of a Lighthouse audit that tells the user why buttons and links need to be big enough and what 'big enough' means. 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: 'Interactive elements like buttons and links should be large enough (48x48px), and have enough space around them, to be easy enough to tap without overlapping onto other elements. [Learn more](https://web.dev/tap-targets/).',
+  description: 'Interactive elements like buttons and links should be large enough (48x48px), and have enough space around them, to be easy enough to tap without overlapping onto other elements. [Learn more about tap targets](https://web.dev/tap-targets/).',
   /** Label of a table column that identifies tap targets (like buttons and links) that have failed the audit and aren't easy to tap on. */
   tapTargetHeader: 'Tap Target',
   /** Label of a table column that identifies a tap target (like a link or button) that overlaps with another tap target. */

package/lighthouse-core/audits/server-response-time.js

@@ -15,7 +15,7 @@ const UIStrings = {
   /** Title of a diagnostic audit that provides detail on how long it took from starting a request to when the server started responding. This imperative title is shown to users when there is a significant amount of execution time that could be reduced. */
   failureTitle: 'Reduce initial server response time',
   /** Description of a Lighthouse audit that tells the user *why* they should reduce the amount of time it takes their server to start responding to requests. 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: 'Keep the server response time for the main document short because all other requests depend on it. [Learn more](https://web.dev/time-to-first-byte/).',
+  description: 'Keep the server response time for the main document short because all other requests depend on it. [Learn more about the Time to First Byte metric](https://web.dev/time-to-first-byte/).',
   /** Used to summarize the total Server Response Time duration for the primary HTML response. The `{timeInMs}` placeholder will be replaced with the time duration, shown in milliseconds (e.g. 210 ms) */
   displayValue: `Root document took {timeInMs, number, milliseconds}\xa0ms`,
 };

package/lighthouse-core/audits/service-worker.js

@@ -17,7 +17,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user why they should use a service worker. 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 service worker is the technology that enables your app to use many ' +
     'Progressive Web App features, such as offline, add to homescreen, and push ' +
-    'notifications. [Learn more](https://web.dev/service-worker/).',
+    'notifications. [Learn more about Service Workers](https://web.dev/service-worker/).',
   /**
    * @description Message explaining that the website may have service workers, but none are in scope to control the tested web page.
    * @example {https://example.com/} pageUrl

package/lighthouse-core/audits/splash-screen.js

@@ -16,8 +16,8 @@ const UIStrings = {
   failureTitle: 'Is not configured for a custom splash screen',
   /** Description of a Lighthouse audit that tells the user why they should configure a custom splash screen. 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 themed splash screen ensures a high-quality experience when ' +
-    'users launch your app from their homescreens. [Learn ' +
-    'more](https://web.dev/splash-screen/).',
+    'users launch your app from their homescreens. ' +
+    '[Learn more about splash screens](https://web.dev/splash-screen/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/themed-omnibox.js

@@ -17,7 +17,7 @@ const UIStrings = {
   failureTitle: 'Does not set a theme color for the address bar.',
   /** Description of a Lighthouse audit that tells the user why they should set a theme color for the browser's address bar. 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 browser address bar can be themed to match your site. ' +
-    '[Learn more](https://web.dev/themed-omnibox/).',
+    '[Learn more about theming the address bar](https://web.dev/themed-omnibox/).',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/third-party-facades.js

@@ -36,7 +36,8 @@ const UIStrings = {
   failureTitle: 'Some third-party resources can be lazy loaded with a facade',
   /** Description of a Lighthouse audit that identifies the third-party code on the page that can be lazy loaded with a facade alternative. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. A facade is a lightweight component which looks like the desired resource. Lazy loading means resources are deferred until they are needed. Third-party code refers to resources that are not within the control of the site owner. */
   description: 'Some third-party embeds can be lazy loaded. ' +
-    'Consider replacing them with a facade until they are required. [Learn more](https://web.dev/third-party-facades/).',
+    'Consider replacing them with a facade until they are required. ' +
+    '[Learn how to defer third-parties with a facade](https://web.dev/third-party-facades/).',
   /** Summary text for the result of a Lighthouse audit that identifies the third-party code on a web page that can be lazy loaded with a facade alternative. This text summarizes the number of lazy loading facades that can be used on the page. A facade is a lightweight component which looks like the desired resource. */
   displayValue: `{itemCount, plural,
   =1 {# facade alternative available}

package/lighthouse-core/audits/third-party-summary.js

@@ -20,7 +20,8 @@ const UIStrings = {
   /** Description of a Lighthouse audit that identifies the code on the page that the user doesn't control. 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: 'Third-party code can significantly impact load performance. ' +
     'Limit the number of redundant third-party providers and try to load third-party code after ' +
-    'your page has primarily finished loading. [Learn more](https://developers.google.com/web/fundamentals/performance/optimizing-content-efficiency/loading-third-party-javascript/).',
+    'your page has primarily finished loading. ' +
+    '[Learn how to minimize third-party impact](https://developers.google.com/web/fundamentals/performance/optimizing-content-efficiency/loading-third-party-javascript/).',
   /** Label for a table column that displays the name of a third-party provider that potentially links to their website. */
   columnThirdParty: 'Third-Party',
   /** Summary text for the result of a Lighthouse audit that identifies the code on a web page that the user doesn't control (referred to as "third-party code"). This text summarizes the number of distinct entities that were found on the page. */

package/lighthouse-core/audits/timing-budget.js

@@ -15,7 +15,7 @@ const UIStrings = {
   /** Title of a Lighthouse audit that compares how quickly the page loads against targets set by the user. Timing budgets are a type of performance budget. */
   title: 'Timing budget',
   /** Description of a Lighthouse audit where a user sets budgets for how quickly the page loads. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Set a timing budget to help you keep an eye on the performance of your site. Performant sites load fast and respond to user input events quickly. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/budgets).',
+  description: 'Set a timing budget to help you keep an eye on the performance of your site. Performant sites load fast and respond to user input events quickly. [Learn more about performance budgets](https://developers.google.com/web/tools/lighthouse/audits/budgets).',
   /** Label for a column in a data table; entries will be the names of different timing metrics, e.g. "Time to Interactive", "First Contentful Paint", etc. */
   columnTimingMetric: 'Metric',
   /** Label for a column in a data table; entries will be the measured value of a particular timing metric. Most entries will have a unit of milliseconds, but units could be other things as well. */

package/lighthouse-core/audits/unsized-images.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Title of a Lighthouse audit that provides detail on whether all images have explicit width and height. This descriptive title is shown to users when one or more images does not have explicit width and height */
   failureTitle: 'Image elements do not have explicit `width` and `height`',
   /** Description of a Lighthouse audit that tells the user why they should include explicit width and height for all images. 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: 'Set an explicit width and height on image elements to reduce layout shifts and improve CLS. [Learn more](https://web.dev/optimize-cls/#images-without-dimensions)',
+  description: 'Set an explicit width and height on image elements to reduce layout shifts and improve CLS. [Learn how to set image dimensions](https://web.dev/optimize-cls/#images-without-dimensions)',
 };
 
 const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);

package/lighthouse-core/audits/user-timings.js

@@ -15,7 +15,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user they may want to use the User Timing API to help measure the performance of aspects of their page load and interaction. 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: 'Consider instrumenting your app with the User Timing API to measure your ' +
       'app\'s real-world performance during key user experiences. ' +
-      '[Learn more](https://web.dev/user-timings/).',
+      '[Learn more about User Timing marks](https://web.dev/user-timings/).',
   /** [ICU Syntax] Label for an audit identifying the number of User Timing timestamps present in the page. */
   displayValue: `{itemCount, plural,
     =1 {1 user timing}

package/lighthouse-core/audits/uses-rel-preconnect.js

@@ -33,7 +33,7 @@ const UIStrings = {
   description:
     'Consider adding `preconnect` or `dns-prefetch` resource hints to establish early ' +
     'connections to important third-party origins. ' +
-    '[Learn more](https://web.dev/uses-rel-preconnect/).',
+    '[Learn how to preconnect to required origins](https://web.dev/uses-rel-preconnect/).',
   /**
    * @description A warning message that is shown when the user tried to follow the advice of the audit, but it's not working as expected.
    * @example {https://example.com} securityOrigin

package/lighthouse-core/audits/uses-rel-preload.js

@@ -20,7 +20,8 @@ const UIStrings = {
   title: 'Preload key requests',
   /** Description of a Lighthouse audit that tells the user *why* they should preload important network requests. The associated network requests are started halfway through pageload (or later) but should be started at the beginning. This is displayed after a user expands the section to see more. No character length limits. '<link rel=preload>' is the html code the user would include in their page and shouldn't be translated. 'Learn More' becomes link text to additional documentation. */
   description: 'Consider using `<link rel=preload>` to prioritize fetching resources that are ' +
-    'currently requested later in page load. [Learn more](https://web.dev/uses-rel-preload/).',
+    'currently requested later in page load. ' +
+    '[Learn how to preload key requests](https://web.dev/uses-rel-preload/).',
   /**
    * @description A warning message that is shown when the user tried to follow the advice of the audit, but it's not working as expected. Forgetting to set the `crossorigin` HTML attribute, or setting it to an incorrect value, on the link is a common mistake when adding preload links.
    * @example {https://example.com} preloadURL

package/lighthouse-core/audits/valid-source-maps.js

@@ -18,7 +18,7 @@ const UIStrings = {
   description: 'Source maps translate minified code to the original source code. This helps ' +
     'developers debug in production. In addition, Lighthouse is able to provide further ' +
     'insights. Consider deploying source maps to take advantage of these benefits. ' +
-    '[Learn more](https://developers.google.com/web/tools/chrome-devtools/javascript/source-maps).',
+    '[Learn more about source maps](https://developers.google.com/web/tools/chrome-devtools/javascript/source-maps).',
   /** Label for a column in a data table. Entries will be URLs to JavaScript source maps. */
   columnMapURL: 'Map URL',
   /** Label for a possible error message indicating that a source map for a large, first-party JavaScript script is missing. */

package/lighthouse-core/audits/viewport.js

@@ -18,7 +18,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user why they should have a viewport meta tag in their html. 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 `<meta name="viewport">` not only optimizes your app for mobile screen sizes, ' +
     'but also prevents [a 300 millisecond delay to user input](https://developers.google.com/web/updates/2013/12/300ms-tap-delay-gone-away). ' +
-    '[Learn more](https://web.dev/viewport/).',
+    '[Learn more about using the viewport meta tag](https://web.dev/viewport/).',
   /** Explanatory message stating that no viewport meta tag exists on the page. */
   explanationNoTag: 'No `<meta name="viewport">` tag found',
 };

package/lighthouse-core/audits/work-during-interaction.js

@@ -28,7 +28,7 @@ const UIStrings = {
   /** Title of a diagnostic audit that provides detail on the main thread work the browser did during a key user interaction. This imperative title is shown to users when there is a significant amount of execution time that could be reduced. */
   failureTitle: 'Minimize work during key interaction',
   /** Description of the work-during-interaction metric. This description is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'This is the thread-blocking work occurring during the Interaction to Next Paint measurement. [Learn more](https://web.dev/inp/).',
+  description: 'This is the thread-blocking work occurring during the Interaction to Next Paint measurement. [Learn more about the Interaction to Next Paint metric](https://web.dev/inp/).',
   /** Label for a column in a data table; entries will be information on the time that the browser is delayed before responding to user input. Ideally fits within a ~40 character limit. */
   inputDelay: 'Input delay',
   /** Label for a column in a data table; entries will be information on the time taken by code processing user input that delays a response to the user. Ideally fits within a ~40 character limit. */