[documentation] A suggestion to improve drupal.org handbooks

[Charlie Lowe]

Ram Dak wrote:

> And, yes, it would be great to have the same stuff in all the three 
> locations- drupal.org handbooks, the module tarballs and the admin>>help 
> section when a module is installed. 

I'd sort of echo and expand upon what Kieran already said. Getting 
people to write documentation is hard enough. Getting it maintained in 
multiple spaces might be super tough.

But this did make me think of one idea. Not sure how hard this is to do, 
but for each module, could we use PHP to pull in the install.txt from 
CVS as a sub-page of the main module page in the "Drupal modules and 
features" handbook? Either that, or have the actual project module page 
automatically pull install.txt from CVS and include it as a link?  We 
could then help module developers to provide better install.txt files 
and focus on what information needs to be provided there. Only one 
document to maintain, too.