Issue #2838571 by nexusnovaz, quietone, Damien Flament: Improve description...

 * 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