[documentation] snippets book

Charlie Lowe cel4145 at cyberdash.com
Mon Nov 28 19:35:14 UTC 2005



Nick Lewis wrote:
> My two cents: Configuration and customization are both giant topics in 
> drupal -- each of which deserves its own top level section. I think 
> people will rarely find info on customization useful if they are looking 
> for configuration, (and vice versa). If you're trying to figure out how 
> to configure cron jobs, a php snippet isn't of much use for you. 
> Moreover, the configuration section is for new users, so we should do 
> all we can to make it straight forward, to the point,  and easy to 
> navigate.

Agreed. It would make sense to split up Configuration and customization 
into two different handbooks. But we'd need a volunteer to do this. My 
guess is it would take a little work.

Note that once the split was made, then it would be possible to link 
from the configuration handbook to relevant sections of the 
customization book, i.e "go here to learn more about customizing X". 
Once again, takes a volunteer.


More information about the documentation mailing list