Quick aside: There is now a doc directory in contrib, specifically for usage docs. There should be more examples coming in the future.
On Aug 26, 1:18 am, ngocdaothanh <ngocdaoth...@gmail.com> wrote: > I think there are a lot of people who need to choose between Clojure > and Scala to study as a "new" language. I must say that both are bad: > * Clojure doc is hard to understand. > * Scala grammar is complicated. > > I prefer Clojure. I think Clojure feature at this time is OK, thus the > decisive point to draw people to Clojure is doc. I wonder if the doc > at this time is obvious for LISP people, but comming from C/C++, Java, > Ruby, and Erlang (Erlang doc is bad, but it is paradise compared to > that of Clojure :D) and even after reading the Clojure book, I must > say that I can't understand 99% of the doc of both clojure and clojure- > contrib. > > For example, what does the following mean? > ------------------------- > (-> x form) > (-> x form & more) > Macro > Threads the expr through the forms. Inserts x as the second item in > the first form, making a list of it if it is not a list already. If > there are more forms, inserts the first form as the second item in > second form, etc. > ------------------------- > > My wish: There are easy-to-understand examples in API doc. > > Rails is easy to use largely because there are examples in doc of > every API function. > > On Aug 26, 12:37 pm, Alan Busby <thebu...@gmail.com> wrote: > > > > > On Wed, Aug 26, 2009 at 5:43 AM, npowell <nathan.pow...@gmail.com> wrote: > > > > I mean, I didn't think the article was terribly in depth, but a real, > > > evenhanded comparison would be enlightening. > > > Reducing it further, I'd be interested just to hear more about the contrast > > of static typing versus macros. Which is more beneficial for different > > situations and why? --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
