Re: Clojure Library Documentation

2009-02-01 Thread e
i was talking about something related in the chat group, but I'm not good enough yet to implement it. I want to rewrite the doc method slightly in a way that would go a LONG way for newbies. The current way actually looks like java . . . like the parens are around the input params. But that's ju

Re: Clojure Library Documentation

2009-02-01 Thread Mark Addleman
More as a note to future Clojure doc'ers than anything else: It seems that noobies (including myself) get bitten by the lazy versus immediate evaluation functions all the time (e.g. for versus doseq/ doall). If this problem isn't solved through naming conventions (probably way too tedious to be

Re: Clojure Library Documentation

2009-01-20 Thread lpetit
Hello, As modest as this could be in the quest of a formal categorization, I find the integrated string pattern search integrated into clojuredev really useful, so I can't resist to do this shameless plug. You can see it in action, with a search on the word "string", either by searching the word

Re: Clojure Library Documentation

2009-01-20 Thread Mark Volkmann
On Tue, Jan 20, 2009 at 10:09 AM, Mark Addleman wrote: > > I'm a long time Java programmer and, before that, a Smalltalker. One > of the major biggest challenges I face when picking up a new language > is getting a working understanding of its libraries. I believe that > standardizing on a doc

Clojure Library Documentation

2009-01-20 Thread Mark Addleman
I'm a long time Java programmer and, before that, a Smalltalker. One of the major biggest challenges I face when picking up a new language is getting a working understanding of its libraries. I believe that standardizing on a doc format was a pretty important driver for Java's success. As I see