[documentation] snippets book

Nick Lewis nick at smartcampaigns.com
Mon Nov 28 17:54:46 UTC 2005


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.

I think dedicating a top level section to code snippets is one of the 
best ideas I've heard on this list in some time. I like "Drupal Hacks" 
too. It might not be the most correct term for the section -- however, 
its a term that 99.9% of people will understand. Its also broad enough 
that it allows the section to expand beyond what is proposed if needed.

Best,
Nick Lewis
http://nicklewis.smartcampaigns.com


Bèr Kessels wrote:

>Op maandag 28 november 2005 17:37, schreef cel4145 at cyberdash.com:
>  
>
>>Why not make this a top level page in the "Configuration and customization"
>>handbook rather than creating a whole new one? Just curious as to why this
>>would not work.
>>
>>Also, could "PHP Code Snippets" be a better title (regardless of location).
>>"Code Forge" sounds good (very SourceForge like), but will it be
>>immediately apparent to people what it is?
>>    
>>
>
>I really like this top level thing and prefer the title. Ill let this rest a 
>little more to let others comment on it, then Ill get this sorted out.
>
> Bèr
>  
>



More information about the documentation mailing list