diff --git a/core/modules/rest/rest.module b/core/modules/rest/rest.module
index 70135e2127..ba61a17fea 100644
--- a/core/modules/rest/rest.module
+++ b/core/modules/rest/rest.module
@@ -35,7 +35,7 @@ function rest_help($route_name, RouteMatchInterface $route_match) {
  * @see rest_update_8401()
  */
 function rest_view_presave(ViewEntityInterface $view) {
-  // Fix the auth options on import, much like what rest_update_8401 does.
+  // Fix the auth options on import, much like what rest_update_8401() does.
   $auth_providers = \Drupal::service('authentication_collector')->getSortedProviders();
   $process_auth = function ($auth_option) use ($auth_providers) {
     foreach ($auth_providers as $provider_id => $provider_data) {
diff --git a/core/modules/rest/src/Plugin/views/display/RestExport.php b/core/modules/rest/src/Plugin/views/display/RestExport.php
index bac63a3b4c..935e599ce8 100644
--- a/core/modules/rest/src/Plugin/views/display/RestExport.php
+++ b/core/modules/rest/src/Plugin/views/display/RestExport.php
@@ -124,8 +124,10 @@ public function __construct(array $configuration, $plugin_id, $plugin_definition
     parent::__construct($configuration, $plugin_id, $plugin_definition, $route_provider, $state);
 
     $this->renderer = $renderer;
-    // Values of "$this->authenticationProviders" - are module names, defining
-    // authentication providers. Only provider IDs should be used for choosing.
+    // $authentication_providers as defined in \Drupal\Core\DependencyInjection\Compiler\AuthenticationProviderPass
+    // and as such it is an array, with authentication providers
+    // (cookie, basic_auth) as keys and modules providing those as values
+    // (user, basic_auth).
     $this->authenticationProviders = array_keys($authentication_providers);
     $this->formatProviders = $serializer_format_providers;
   }