diff -u b/core/includes/menu.inc b/core/includes/menu.inc --- b/core/includes/menu.inc +++ b/core/includes/menu.inc @@ -49,6 +49,8 @@ * * @todo The rest of this topic has not been reviewed or updated for Drupal 8.x * and is not correct! + * @todo It is quite likely that hook_menu() will be replaced with a different + * hook, configuration system, or plugin system before the 8.0 release. * * Drupal's menu system follows a simple hierarchy defined by paths. * Implementations of hook_menu() define menu items and assign them to