README.txt

Place downloaded and custom modules that extend your site functionality beyond
Drupal core in this directory to ensure clean separation from core modules and
to facilitate safe, self-contained code updates. Contributed modules from the
Drupal community may be downloaded at http://drupal.org/project/modules.

It is safe to organize modules into subdirectories, such as "contrib" for
contributed modules, and "custom" for custom modules. Note that if you move a
module to a subdirectory after it has been enabled, you may need to clear the
Drupal cache so that it can be found.

In multisite configuration, modules found in this directory are available to
all sites. In addition to this directory, shared common modules may also be kept
in the sites/all/modules directory and will take precedence over modules in this
directory. Alternatively, the sites/your_site_name/modules directory pattern may
be used to restrict modules to a specific site instance.

Refer to the "Developing for Drupal" section of the README.txt in the Drupal
root directory for further information on extending Drupal with custom modules.

File

drupal/modules/README.txt
View source
  1. Place downloaded and custom modules that extend your site functionality beyond
  2. Drupal core in this directory to ensure clean separation from core modules and
  3. to facilitate safe, self-contained code updates. Contributed modules from the
  4. Drupal community may be downloaded at http://drupal.org/project/modules.
  5. It is safe to organize modules into subdirectories, such as "contrib" for
  6. contributed modules, and "custom" for custom modules. Note that if you move a
  7. module to a subdirectory after it has been enabled, you may need to clear the
  8. Drupal cache so that it can be found.
  9. In multisite configuration, modules found in this directory are available to
  10. all sites. In addition to this directory, shared common modules may also be kept
  11. in the sites/all/modules directory and will take precedence over modules in this
  12. directory. Alternatively, the sites/your_site_name/modules directory pattern may
  13. be used to restrict modules to a specific site instance.
  14. Refer to the "Developing for Drupal" section of the README.txt in the Drupal
  15. root directory for further information on extending Drupal with custom modules.