[RPP Observations] Update definition of "field data" in translation contexts

Bug: None
Change-Id: I6f3cf66452585df8d909ac3c38a5592638ebcb4c
Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/6079049
Reviewed-by: Connor Clark <[email protected]>
Reviewed-by: Simon Zünd <[email protected]>
Commit-Queue: Adam Raine <[email protected]>

Author: Adam Raine

front_end/panels/timeline/components/LiveMetricsView.ts

@@ -45,7 +45,7 @@ const RTT_MINIMUM = 60;
 
 const UIStrings = {
   /**
-   * @description Title of a view that shows performance metrics from the local environment and field metrics collected from real users in the field.
+   * @description Title of a view that shows performance metrics from the local environment and field metrics collected from real users. "field metrics" should be interpreted as "real user metrics".
    */
   localAndFieldMetrics: 'Local and field metrics',
   /**
@@ -69,15 +69,15 @@ const UIStrings = {
    */
   nextSteps: 'Next steps',
   /**
-   * @description Title of a section that shows options for how real user data in the field should be fetched.
+   * @description Title of a section that shows options for how real user data in the field should be fetched. This should be interpreted as "Real user data".
    */
   fieldData: 'Field data',
   /**
    * @description Title of a section that shows settings to control the developers local testing environment.
    */
   environmentSettings: 'Environment settings',
   /**
-   * @description Label for an select box that selects which device type field data be shown for (e.g. desktop/mobile/all devices/etc).
+   * @description Label for an select box that selects which device type field data be shown for (e.g. desktop/mobile/all devices/etc). "field data" should be interpreted as "real user data".
    * @example {Mobile} PH1
    */
   showFieldDataForDevice: 'Show field data for device type: {PH1}',
@@ -91,7 +91,7 @@ const UIStrings = {
    */
   network: 'Network: {PH1}',
   /**
-   * @description Label for an select box that selects which device type field data be shown for (e.g. desktop/mobile/all devices/etc).
+   * @description Label for an select box that selects which device type real user data should be shown for (e.g. desktop/mobile/all devices/etc).
    * @example {Mobile} PH1
    */
   device: 'Device: {PH1}',
@@ -145,7 +145,7 @@ const UIStrings = {
    */
   originOptionWithKey: 'Origin: {PH1}',
   /**
-   * @description Label for an combo-box that indicates if field data should be taken from the page's URL or it's origin/domain.
+   * @description Label for an combo-box that indicates if field data should be taken from the page's URL or it's origin/domain. "field data" should be interpreted as "real user data".
    * @example {Origin: https://example.com} PH1
    */
   showFieldDataForPage: 'Show field data for {PH1}',
@@ -210,11 +210,11 @@ const UIStrings = {
    */
   seeHowYourLocalMetricsCompare: 'See how your local metrics compare to real user data in the {PH1}.',
   /**
-   * @description Text for a link that goes to more documentation about local and field data. "Local" refers to performance metrics measured in the developers local environment. "field data" is data measured by real users in the field.
+   * @description Text for a link that goes to more documentation about local and field data. "Local" refers to performance metrics measured in the developers local environment. "field data" should be interpreted as "real user data".
    */
   localFieldLearnMoreLink: 'Learn more about local and field data',
   /**
-   * @description Tooltip text for a link that goes to documentation explaining the difference between local and field metrics. "Local metrics" are performance metrics measured in the developers local environment. "field data" is data measured by real users in the field.
+   * @description Tooltip text for a link that goes to documentation explaining the difference between local and field metrics. "Local metrics" are performance metrics measured in the developers local environment. "field data" should be interpreted as "real user data".
    */
   localFieldLearnMoreTooltip:
       'Local metrics are captured from the current page using your network connection and device. Field data is measured by real users using many different network connections and devices.',

front_end/panels/timeline/components/MetricCard.ts

@@ -31,7 +31,7 @@ const UIStrings = {
    */
   localValue: 'Local',
   /**
-   * @description Label for the 75th percentile of a metric according to data collected from real users in the field.
+   * @description Label for the 75th percentile of a metric according to data collected from real users in the field. This should be interpreted as "75th percentile of real users".
    */
   field75thPercentile: 'Field 75th percentile',
   /**

front_end/panels/timeline/components/MetricCompareStrings.ts

@@ -90,7 +90,7 @@ const UIStrings = {
    */
   poorSummarized: 'Your local {PH1} value of {PH2} is poor.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -99,7 +99,7 @@ const UIStrings = {
   goodGoodDetailedCompare:
       'Your local {PH1} value of {PH2} is good and is rated the same as {PH4} of real-user {PH1} experiences. Additionally, the field data 75th percentile {PH1} value of {PH3} is good.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -108,7 +108,7 @@ const UIStrings = {
   goodNeedsImprovementDetailedCompare:
       'Your local {PH1} value of {PH2} is good and is rated the same as {PH4} of real-user {PH1} experiences. However, the field data 75th percentile {PH1} value of {PH3} needs improvement.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -117,7 +117,7 @@ const UIStrings = {
   goodPoorDetailedCompare:
       'Your local {PH1} value of {PH2} is good and is rated the same as {PH4} of real-user {PH1} experiences. However, the field data 75th percentile {PH1} value of {PH3} is poor.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -126,7 +126,7 @@ const UIStrings = {
   needsImprovementGoodDetailedCompare:
       'Your local {PH1} value of {PH2} needs improvement and is rated the same as {PH4} of real-user {PH1} experiences. However, the field data 75th percentile {PH1} value of {PH3} is good.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -135,7 +135,7 @@ const UIStrings = {
   needsImprovementNeedsImprovementDetailedCompare:
       'Your local {PH1} value of {PH2} needs improvement and is rated the same as {PH4} of real-user {PH1} experiences. Additionally, the field data 75th percentile {PH1} value of {PH3} needs improvement.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -144,7 +144,7 @@ const UIStrings = {
   needsImprovementPoorDetailedCompare:
       'Your local {PH1} value of {PH2} needs improvement and is rated the same as {PH4} of real-user {PH1} experiences. However, the field data 75th percentile {PH1} value of {PH3} is poor.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -153,7 +153,7 @@ const UIStrings = {
   poorGoodDetailedCompare:
       'Your local {PH1} value of {PH2} is poor and is rated the same as {PH4} of real-user {PH1} experiences. However, the field data 75th percentile {PH1} value of {PH3} is good.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3
@@ -162,7 +162,7 @@ const UIStrings = {
   poorNeedsImprovementDetailedCompare:
       'Your local {PH1} value of {PH2} is poor and is rated the same as {PH4} of real-user {PH1} experiences. However, the field data 75th percentile {PH1} value of {PH3} needs improvement.',
   /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3

scripts/generate_metric_compare_strings.js

@@ -60,7 +60,7 @@ for (const [localRating, localRatingText] of Object.entries(ratings)) {
     const tag = camelize(localRating) + capitalizeFirstLetter(camelize(fieldRating)) + 'DetailedCompare';
     const transition = localRating === fieldRating ? 'Additionally' : 'However';
     console.log(`  /**
-   * @description Text block that compares a local metric value to real user experiences. "field data" refers to performance data collected from real users on the site. "local" refers to a developers local testing environment.
+   * @description Text block that compares a local metric value to real user experiences. "field data" should be interpreted as "real user data". "local" refers to a developers local testing environment.
    * @example {LCP} PH1
    * @example {500 ms} PH2
    * @example {400 ms} PH3