Issue #2838571: Altered docblock comment for hook_menu_links_discovered_alter

Closes #2838571

core/lib/Drupal/Core/Menu/menu.api.php

@@ -224,8 +224,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