Re: How about a 'recipes' page in the wiki ?

[muppet <scott asofyet org>]

On Apr 27, 2005, at 8:44 PM, ofey aikon wrote:

> > > Or ::Cookbook, as a collection of recipes would customarily be
> > > called. :-)
> >
> > actually i wouldn't necessarily expect the recipes/cookbook style 
> > stuff to be
> > runnable scripts anyway. they should be stripped down to only the 
> > relevant
> > portion of code with lots of discussion and comments. if someone out 
> > there has
>
> How about collecting all examples into a package called
> Gtk2::Ex::Cookbook.

Gtk-Perl included a cookbook manpage, which was quite helpful, but 
disappointingly short.  It contained snippets showing only the relevant 
code to accomplish some task (splash screen and validating input in an 
entry), as well as a crash-course intro to Gtk, and it was installed 
with the binding so that you didn't have to have a network connection 
in order to read it.
http://aspn.activestate.com/ASPN/CodeDoc/Gtk-Perl/Gtk/cookbook.html

The precedent for a cookbook-style document is, i think, The Perl 
Cookbook.  Problem, Solution, Discussion.  I think it would be very 
good to have a document of this form, and i like wikis because it 
removes the problem of maintenance of the document, albeit at the 
expense of requiring a network connection to read it.

Working examples are nice, but the problem is twofold: realistic 
examples are dauntingly large (e.g. histogramplot.pl), and small 
educational examples are trivial and don't give enough context.  
There's also the problem that writing exemplary code is Hard.


--
Brian: If i recall correctly, this is the physics department.
Chris: That explains all that gravity.
        -- Family Guy, "The Story on Page One"