On Fri, 2 Jul 2010 14:50:18 -0700 (PDT) Justin Kramer <jkkra...@gmail.com> wrote:
> Nice, Mike. I stole your work and put it into the Wiki I created to > see how it fit: > > http://clojure-examples.appspot.com/clojure.core/reduce Well, I like it, but I might be a bit biased. I think the important part is the rules that went into picking the examples. I just picked examples from Walton that followed them, tweaked those to build up properly, and then added the edge cases. http://clojure-examples.appspot.com/guidelines actually covers it, but my version was more explicit, and gave a why. Cleaning mine version up and combining them gives: * Keep it simple and self contained - the first example shouldn't require knowing anything but clojure syntax - the inputs to an example should either be literals or simple expressions - the user shouldn't have to figure out anything but the new concept or type * Build up examples cumulatively - each example should introduce at most one new concept - or reinforce the previous example (though that should be kept to a minimum) - or show the function working on a new data type I'd go ahead and edit the page, but figure you might want to such a change beforehand. <mike -- Mike Meyer <m...@mired.org> http://www.mired.org/consulting.html Independent Network/Unix/Perforce consultant, email for more information. O< ascii ribbon campaign - stop html mail - www.asciiribbon.org -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en
