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

[greggles]

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:     bug reports
 Priority:     minor
 Assigned to:  Anonymous
 Reported by:  vjordan
 Updated by:   greggles
-Status:       patch (code needs review)
+Status:       active

This seems like a good improvement.


I'm changing the status as this is not a patch - see
http://drupal.org/diffandpatch for instructions on creating patches.


For relatively trivial changes like docs I think it can be useful to
decide on the text prior to creating the patch.  My preference would be
for the language to read:


These installation-wide modules and themes should be placed in 
subdirectories called modules and themes as follows:
   settings/all/modules
   settings/all/themes




greggles



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



------------------------------------------------------------------------

Tue, 05 Dec 2006 13:29:15 +0000 : vjordan

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