On Thu, Jul 7, 2011 at 6:12 AM, Stuart Halloway <stuart.hallo...@gmail.com> wrote: > (1) Edit and improve the official > docs: http://dev.clojure.org/display/doc/Getting+Started
I think one sticking point here is that there are (so far) seven IDEs/editors listed and five build tools. For a n00b, that's too much choice. There have been discussions about http://clojure.org/getting_started in the past but it's still showing the (fairly horrible) instructions that start with talk of a source code repository, a ZIP file and bytecode generation(!). There needs to be a decision by the core team on a single, recommended, _simple_ getting started process and update that page to show that (please: lein). Beyond that simple process, it can point to the dev wiki with the list of IDEs and build tools. The problem here is there needs to be more proscription around Getting Started so n00bs aren't completely confused by either the primitive instructions (clojure.org) or overwhelmed by choice (dev.clojure.org). > (2) Link to the official docs, and help us do the same. clojure.org has a > slower update process than the dev site (by design!) but if there is > something wrong, or a place where it needs to link out, please let us know! See above. Suggestions have been made about making clojure.org/getting_started better :) > (3) Encourage people who wrote a blog post 18 months ago that is now filled > with misinformation (as things have moved on) to go back and add a link to > the official docs. Definitely a good point. I'll go back over my blog posts for Clojure and update anything that's wrong (I think I already updated some of my Getting Started stuff but I'll double-check). -- Sean A Corfield -- (904) 302-SEAN An Architect's View -- http://corfield.org/ World Singles, LLC. -- http://worldsingles.com/ Railo Technologies, Inc. -- http://www.getrailo.com/ "Perfection is the enemy of the good." -- Gustave Flaubert, French realist novelist (1821-1880) -- 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
