Issue #376391 by mimran, snehi: Document that module_invoke_all / ModuleHandlerInterface::invokeAll reindexes arrays

core/lib/Drupal/Core/Extension/ModuleHandlerInterface.php

@@ -237,7 +237,9 @@ interface ModuleHandlerInterface {
    *
    * @return array
    *   An array of return values of the hook implementations. If modules return
-   *   arrays from their implementations, those are merged into one array.
+   *   arrays from their implementations, those are merged into one array
+   *   recursively. Note: integer keys in arrays will be lost, as the merge is
+   *   done using array_merge_recursive().
    */
   public function invokeAll($hook, array $args = array());