diff --git a/core/modules/rest/rest.module b/core/modules/rest/rest.module
--- a/core/modules/rest/rest.module
+++ b/core/modules/rest/rest.module
@@ -24,6 +24,12 @@ function rest_help($route_name, RouteMatchInterface $route_match) {
       $output .= '<dt>' . t('Enabling REST support for an entity type') . '</dt>';
       $output .= '<dd>' . t('REST support for content types (provided by the <a href=":node">Node</a> module) is enabled by default. To enable support for other content entity types, you can use a <a href=":config" target="blank">process based on configuration editing</a> or the contributed <a href=":restui">REST UI module</a>.', [':node' => (\Drupal::moduleHandler()->moduleExists('node')) ? \Drupal::url('help.page', ['name' => 'node']) : '#', ':config' => 'https://www.drupal.org/documentation/modules/rest', ':restui' => 'https://www.drupal.org/project/restui']) . '</dd>';
       $output .= '<dd>' . t('You will also need to grant anonymous users permission to perform each of the REST operations you want to be available, and set up authentication properly to authorize web requests.') . '</dd>';
+      $output .= '<dt>' . t('General') . '</dt>';
+      $output .= '<dd>' . t('The <a href=":rest-docs">RESTful Web Services</a> and <a href=":jsonapi-docs">JSON:API</a> modules serve similar purposes. <a href=":comparison">Read the comparison of the RESTFul Web Services and JSON:API modules</a> to determine the best choice for your site.', [
+        ':rest-docs' => 'https://www.drupal.org/docs/8/core/modules/rest',
+        ':jsonapi-docs' => 'https://www.drupal.org/docs/8/modules/json-api',
+        ':comparison' => 'https://www.drupal.org/docs/8/modules/jsonapi/jsonapi-vs-cores-rest-module',
+      ]) . '</dd>';
       $output .= '</dl>';
       return $output;
   }