I've integrated your suggestions into the wiki's guidelines: http://clojure-examples.appspot.com/guidelines
Feel free to add anything else that needs mentioning. There's also a talk page for discussion. Justin On Jul 2, 6:37 pm, Mike Meyer <mwm-keyword-googlegroups. 620...@mired.org> wrote: > 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/guidelinesactually 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
