diff --git a/core/modules/rest/rest.install b/core/modules/rest/rest.install
index f969117..0f09906 100644
--- a/core/modules/rest/rest.install
+++ b/core/modules/rest/rest.install
@@ -31,11 +31,11 @@ function rest_requirements($phase) {
 
     if (\Drupal::config('serialization.settings')->get('bc_primitives_as_strings')) {
       $requirements['rest_serialization_as_strings']['value'] = t('Enabled');
-      $requirements['rest_serialization_as_strings']['description'] = t('The REST API outputs all values as strings. If your site depends on these value being typed, <a href="https://www.drupal.org/node/2837696">read the change record to learn how to disable the BC mode.</a>');
+      $requirements['rest_serialization_as_strings']['description'] = t('The Serialization API is configured to output only string values for REST and other applications (instead of integers or Booleans when appropriate). <a href="https://www.drupal.org/node/2837696">Disabling this backwards compatibility mode</a> is recommended unless your sites or applications require string output.');
     }
     else {
       $requirements['rest_serialization_as_strings']['value'] = t('Not enabled');
-      $requirements['rest_serialization_as_strings']['description'] = t('The REST API outputs typed values. Integers/booleans will be used where appropriate. If your site depends on these value being strings, <a href="https://www.drupal.org/node/2837696">read the change record to learn how to enable the BC mode.</a>');
+      $requirements['rest_serialization_as_strings']['description'] = t('The Serialization API is configured with the recommended default and outputs typed values (integers, Booleans, or strings as appropriate) for REST and other applications. If your site or applications require string output, you can <a href="https://www.drupal.org/node/2837696">enable backwards compatibility mode</a>.');
     }
   }