diff --git a/core/lib/Drupal/Core/Config/ConfigManager.php b/core/lib/Drupal/Core/Config/ConfigManager.php
index bb923e2a21..0761cb7398 100644
--- a/core/lib/Drupal/Core/Config/ConfigManager.php
+++ b/core/lib/Drupal/Core/Config/ConfigManager.php
@@ -300,10 +300,11 @@ public function getConfigEntitiesToChangeOnDependencyRemoval($type, array $names
     // us to determine how the dependency graph changes as entities are fixed by
     // calling the onDependencyRemoval() method. The variables are:
     // - $dependents is the list of dependencies to process. This list changes
-    //   as entities processed and are fixed or deleted.
+    //   as entities are processed and either fixed or deleted.
     // - $current_dependencies is the list of dependencies on $names. This list
-    //   changes as entities processed and are fixed or deleted. This list is
-    //   passed to onDependencyRemoval() as the list of affected entities.
+    //   is recalculated when calling an entity's onDependencyRemoval() method
+    //   results in the entity changing. This list is passed to each entity's
+    //   onDependencyRemoval() method as the list of affected entities.
     // - $original_dependencies is the list of original dependencies on $names.
     //   This list never changes.
     $original_dependencies = $current_dependencies = $dependents;