On 27/03/13 03:13, Michael Klishin wrote:
Complain loudly to maintainers on this list that their documentation
has gaps and they should
clarify this and that. The idea that people should read the source to
get reasonably straightforward
stuff done is wrong and does a lot of long term damage to the community.
what I really meant was that both of us (Ryan and me) would have
benefited by looking at the sources. It would have been immediately
clear that 'fields' expects a vector argument....I even rushed to infer
what the fn expects which proved wrong 2 minutes later!
In any case, for me, reading the sources has always helped...in fact,
unless you read/study the sources there is no way to make meaningful
comments/corrections about a library. Yes, the docs should always be
clear with regards to usage but being able to consult the source
relatively easily, is invaluable (at least for me)...
Jim
ps: by no means I meant "read the source before posting here"...my
comment was closer to "read the sources - it's good for you - you'll
learn stuff and potentially save time & effort" :)
--
--
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
---
You received this message because you are subscribed to the Google Groups "Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
