[Grok-dev] Re: The Grok Learning Curve

[Sebastian Ware]

I don't agree that recipes only are for experts (consumer cook books  
are rather popular after all...:)), but I agree that one will expect  
them to be narrow in scope. By lowering the bar, recipes will be  
easier to create and maintain. Personally I like recipes far better  
than tutorial since they allow me a non-linear learning path.

Mvh Sebastian

20 aug 2007 kl. 20.59 skrev Brandon Craig Rhodes:

> Darryl Cousins <darryl at darrylcousins.net.nz> writes:
>
>> The term `recipes` appears to have stuck (that was my +1), if no
>> -1's in the next week I'll edit grok/trunk/doc/* and www accordingly
>> and also move `minitutorials` on svn to `recipes`.
>
> -1
>
> I prefer "tutorial" to "recipe", because a "recipe" usually means
> something written for an expert.  The term "recipe" comes from
> cooking.  A recipe assumes you know already what it means to "chop",
> "dice", "mix", "bake", "fillet", and so forth, and is essentially a
> way that one expert can communicate to another expert the particulars
> of making a particular dish.  But you cannot learn to cook through a
> series of recipes.
>
> A document, on the other hand, that helps a new cook learn how to
> "bake", and explains everything about what "baking" accomplishes and
> the different ways to "bake", would *not* be a recipe.  It might even
> be called a "tutorial". :-)
>
> -- 
> Brandon Craig Rhodes   brandon at rhodesmill.org   http:// 
> rhodesmill.org/brandon
> _______________________________________________
> Grok-dev mailing list
> Grok-dev at zope.org
> http://mail.zope.org/mailman/listinfo/grok-dev