- Patch #360415 by JuliaKM, ultimateboy, keith.smith et al: improved instructions.

sites/all/README.txt

@@ -1,9 +1,8 @@
 // $Id$
 
 This directory should be used to place downloaded and custom modules
-and themes which are common to all sites. This will allow you to
-more easily update Drupal core files. These modules and themes should
-be placed in subdirectories called modules and themes as follows:
+and themes which are common to all sites. Keeping contributed and
+custom modules and themes in the sites directory will aid in upgrading
+Drupal core files. Place contributed and custom modules and themes in
+the sites/all/modules and sites/all/themes directories respectively.
 
-  sites/all/modules
-  sites/all/themes