On Sep 19, 2012, at 12:11 AM, kovas boguta wrote: > On Wed, Sep 19, 2012 at 1:12 AM, Andy Fingerhut > <andy.finger...@gmail.com> wrote: >> On Tue, Sep 18, 2012 at 9:01 PM, Paul deGrandis <paul.degran...@gmail.com> >> wrote: >>> >>> 1.) Clojure.org should have a better host of documentation, especially for >>> newcomers. >> The only things required for someone to create a new web site dedicated to >> better Clojure documentation is time, knowledge, and some money. > > There are several intermingled issues: > > 1. People want to feel involved. Its the opposite of "founding" a new > project, on your own. That their modest effort will be seen by others, > since its a part of this bigger thing. Contributing to clojure.org > versus your own personal project are 2 different things.
Kovas, have you used ClojureDocs.org? If not, I recommend trying it out. In under 5 minutes, you should be able to figure out how to add an example. One or two people started it, and dozens if not hundreds have added anywhere from 5 minutes to hours worth of extra effort adding examples. Several times in the last few months, there have been discussions on this list about what the documentation should say about a function. It takes me longer to think of what to add to ClojureDocs.org for the function than it does to go through the steps to add it. Your suggestions and mine are not mutually exclusive -- my suggestion is that one enable the other. A few people create an updated site that makes it as easy as ClojureDocs.org for everyone else who is willing to make a modest effort that will be seen by others. I'm not proposing that hundreds of people go out and create such a web site. Whether I did or not, I'm sure it wouldn't happen :-) Andy -- 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
