[documentation] snippets book

[Farsheed]

I would suggest keeping the name "PHP Snippets" for
snippets of PHP code, because that's what they are. 
Also remember hack has a negative connotation, i.e.
"It's hacked together" and it also suggests that it
takes some skill to hack. I think it's important to
describe things as simply and accurately as possible.
I also agree with Nick about Configuration and
Customization being top level books. Maybe something
like:

Customization
-PHP Snippets
--block snippets
--page snippets
-Theme building
--theme tricks and methods
-Module building
--module testing and tricks (how did you start
learning to code modules?)
-Other tricks

Configuration
-How to get your site going once installed
--roles, permissions
--general settings
--theme config
--adding new modules
--module config
--block config
-User submitted configurations/descriptions of their
drupal site
-etc...

The beauty of the php snippets page that Dub started
was that it was fairly informal as well, so I would
say -1 to putting it in CVS, but +1 to encouraging
comments from more experienced Drupallers.  No need to
scare off newbies here.  Also because Dub started the
PHP Snippets book, I think we should really consult
him before reorganizing it. 

Farsheed


--- Charlie Lowe <cel4145 at cyberdash.com> wrote:

> 
> 
> 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.
> -- 
> [ documentation |
> http://lists.drupal.org/listinfo/documentation ]
> 


__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com