[documentation] snippets book

[Laura Scott]

I think this is a wonderful idea. ++++1 from me!

I always find the snippets to be hard to find, and under sometimes 
counterintuitive names.

Other code forge items could be module hacks that are not committed to 
the module itself, but might come in handy for some. This could also end 
up being a DIY learning area, where people are encouraged to "get under 
the hood" and really try some custom things.

Laura


Bèr Kessels wrote:
> Hi,
>
> We have quite some snippets, hidden away, deep in the handbooks. I wuold like 
> to see them get more love and more hands.
> In order to have good copy-pastable theme functions, php blocks and so, we 
> ned:
> * good peer reviews. now any fool can paste a nasty phpblock that ni fact just 
> fubars someones database
> * Improvements. I often see phpblocks that I would not even feed to my dog. 
> They are written in horrible bloated PHP, dont use any drupal functions or 
> sometimes are plain insecure.
> * input: the more the better
> * findability. I think copy-pastable code is usefull for users. They can have 
> blocks and so without going trough all the hassle of installnig modules (that 
> give loads of unwanted features often too)
>
> So, can we not open a new handbook, "forge", instead of having them spread 
> over administration/development?
>
> And can we have one + three new terms:
> * Code Forge
>  ** Block snippets
>  ** Page snippets
>  ** Template snippets
>
>  Bèr
>   
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20051128/a902bb12/attachment-0001.htm