Issue #2642824 by chx, jhodgdon: Document extension_discovery_scan_tests setting everywhere

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

@@ -15,6 +15,13 @@
 
 /**
  * Discovers available extensions in the filesystem.
+ *
+ * To also discover test modules, add
+ * @code
+ * $settings['extension_discovery_scan_tests'] = TRUE;
+ * @encode
+ * to your settings.php.
+ *
  */
 class ExtensionDiscovery {
 
@@ -134,6 +141,12 @@ public function __construct($root, $use_file_cache = TRUE, $profile_directories
    * - the site-wide directory; i.e., /
    * - the site-specific directory; e.g., /sites/example.com
    *
+   * To also find test modules, add
+   * @code
+   * $settings['extension_discovery_scan_tests'] = TRUE;
+   * @encode
+   * to your settings.php.
+   *
    * The information is returned in an associative array, keyed by the extension
    * name (without .info.yml extension). Extensions found later in the search
    * will take precedence over extensions found earlier - unless they are not

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

@@ -23,6 +23,12 @@ interface ModuleInstallerInterface {
    *   - Invoke hook_install() and add it to the list of installed modules.
    * - Invoke hook_modules_installed().
    *
+   * To install test modules add
+   * @code
+   * $settings['extension_discovery_scan_tests'] = TRUE;
+   * @encode
+   * to your settings.php.
+   *
    * @param string[] $module_list
    *   An array of module names.
    * @param bool $enable_dependencies

core/modules/simpletest/src/KernelTestBase.php

@@ -485,6 +485,12 @@ protected function installEntitySchema($entity_type_id) {
   /**
    * Enables modules for this test.
    *
+   * To install test modules outside of the testing environment, add
+   * @code
+   * $settings['extension_discovery_scan_tests'] = TRUE;
+   * @encode
+   * to your settings.php.
+   *
    * @param array $modules
    *   A list of modules to enable. Dependencies are not resolved; i.e.,
    *   multiple modules have to be specified with dependent modules first.

core/modules/simpletest/src/WebTestBase.php

@@ -1010,6 +1010,12 @@ protected function initKernel(Request $request) {
   /**
    * Install modules defined by `static::$modules`.
    *
+   * To install test modules outside of the testing environment, add
+   * @code
+   * $settings['extension_discovery_scan_tests'] = TRUE;
+   * @encode
+   * to your settings.php.
+   *
    * @param \Symfony\Component\DependencyInjection\ContainerInterface $container
    *   The container.
    */

core/tests/Drupal/KernelTests/KernelTestBase.php

@@ -786,6 +786,12 @@ protected function installEntitySchema($entity_type_id) {
   /**
    * Enables modules for this test.
    *
+   * To install test modules outside of the testing environment, add
+   * @code
+   * $settings['extension_discovery_scan_tests'] = TRUE;
+   * @encode
+   * to your settings.php.
+   *
    * @param string[] $modules
    *   A list of modules to enable. Dependencies are not resolved; i.e.,
    *   multiple modules have to be specified individually. The modules are only