diff --git a/core/lib/Drupal/Core/Extension/module.api.php b/core/lib/Drupal/Core/Extension/module.api.php
index 63f81b280dddc0b6b2185f81960e38febc13c4f9..195c6cddbb4d295fd16eb2b31359e5ec5ca80ed8 100644
--- a/core/lib/Drupal/Core/Extension/module.api.php
+++ b/core/lib/Drupal/Core/Extension/module.api.php
@@ -125,6 +125,8 @@ function hook_module_preinstall($module) {
  * \Drupal\Core\Extension\ModuleHandler::install() for a detailed description of
  * the order in which install hooks are invoked.
  *
+ * This hook should be implemented in a .module file, not in an .install file.
+ *
  * @param $modules
  *   An array of the modules that were installed.
  *