diff --git a/core/lib/Drupal/Core/Menu/menu.api.php b/core/lib/Drupal/Core/Menu/menu.api.php
index d15ecc38cd337b3c239f9c2065bb7e6cf4c87387..8923448314a2398ce8bd9c89015954afb8471bc0 100644
--- a/core/lib/Drupal/Core/Menu/menu.api.php
+++ b/core/lib/Drupal/Core/Menu/menu.api.php
@@ -222,8 +222,8 @@
  * Alters all the menu links discovered by the menu link plugin manager.
  *
  * @param array &$links
- *   The link definitions to be altered. Each link has a key that is the machine
- *   name, which must be unique. By default, use the route name as the
+ *   The discovered menu links to be altered. Each link has a key that is the
+ *   machine name, which must be unique. By default, use the route name as the
  *   machine name. In cases where multiple links use the same route name, such
  *   as two links to the same page in different menus, or two links using the
  *   same route name but different route parameters, the suggested machine name