Andy Fingerhut:

> On Tue, Sep 18, 2012 at 9:01 PM, Paul deGrandis 
> <paul.de...@gmail.com<javascript:>
> > wrote:
>
>>
>> 1.) Clojure.org should have a better host of documentation, especially 
>> for newcomers.
>> We saw from the Clojure Survey, as well as threads here on the mailing 
>> list, that documentation is still something on which we as a community need 
>> to work.
>> Could perhaps a different process govern documentation contributions, 
>> something more akin to http://docs.scala-lang.org/contribute.html that 
>> doesn't involve the CA?
>> How could we best integrate such a project into Clojure.org?  Would 
>> anyone be willing to help push such a project forward?
>>
>
> my guess is that it would be easier to create a new site than to expect 
> someone else to do an overhaul on clojure.org.  You would own your own 
> destiny.  You would never need to wait on someone else to do something for 
> you, unless it was someone at the company you chose to host your site, or 
> one of your colleagues to do their part.
>
> It is quick and easy for clojure.org to add one or several links to such 
> a site once it is up and going.
>

This suggestion ignores the fact that most newcomers are much more likely 
to head to clojure.org instead of some third party site and expect 
clojure.org
to be at least somewhat helpful.

Currently I advice Clojure newcomers to not use clojure.org for anything, 
it is hopelessly outdated, reference-oriented and will only confuse them 
more.
Unsurprisingly, this does not encourage newcomers as they think that many 
other things are hopelessly broken and outdated in this community.

clojure.org needs change, adding a yet another link won't help.

 MK

-- 
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

Reply via email to