[documentation] [Documentation bug] sites/all/README.txt clarification suggested

[vjordan]

Issue status update for 
http://drupal.org/node/101455
Post a follow up: 
http://drupal.org/project/comments/add/101455

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
-Category:     feature requests
+Category:     bug reports
 Priority:     minor
 Assigned to:  Anonymous
 Reported by:  vjordan
 Updated by:   vjordan
 Status:       patch (code needs review)

Actually, I think this is a bug report of sorts, rather than a feature
request.




vjordan



Previous comments:
------------------------------------------------------------------------

Tue, 05 Dec 2006 13:28:19 +0000 : vjordan

When experimenting with various installs of 5.0-beta2 I even read some
of the documentation. One piece that confused me was
sites/all/README.txt


// $Id: README.txt,v 1.1 2006/11/11 22:53:59 drumm Exp $

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.


When I put a custom module in this directory it wasn't found by Drupal
v5 and couldn't be configured. I subsequently found that when I used a
subdirectory for the downloaded modules called "modules" Drupal V5 was
able to find them. I presume a similar directory naming is required for
themes also.


Now so long as I've understood this correctly I suggest the README.txt
wording is changed:



// $Id: README.txt, ...

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.

All downloaded custom modules should be placed in a subdirectory called

modules and all custom themes should be placed in a subdirectory called

themes as follows:
   settings/all/modules
   settings/all/themes