> The community getting started page could be much better. In particular, > people have opined that there should be a clear, no-choices- > to-make path "For Newbies" section.Help welcome!
I just got edit privileges on dev.clojure and am eager work on it. How do people want to see Getting Started on dev.clojure organized? Right now there are 12 (!) headings right under Getting Started. How about reducing it to four: 1) Getting Clojure 2) Editing Clojure 3) Using Clojure 4) Tools This is the order in which newcomers need to do things. Under 1) would be a guide for setting up Lein with the Lein REPL. At the end would be a list of links for alternative options. Under 2) would be a guide for setting up Emacs (immediately divided into Mac, Windows, Linux). At the end would be a list of alternative options: Eclipse, Netbeans, IntelliJ, etc. Under 3), guides to setting up web programming (+ ClojureScript now?), Incanter, and any other killer apps---but not an infinite list by any means. Less common applications again would be relegated to links (which may link within dev.clojure of course). Under 4), anything that doesn't fit under the first three: build tools and debuggers with a standard option for each, and once again alternative choices at the end. (Lein has of course already been covered.) The basic idea is to make some choices, and tuck all the extra information out of the top level. Perhaps there could also be a link at the top for an index to everything, as well. If we really wanted to be radically open, we could include with each option some of the data from the recent State of Clojure survey, describing what proportion of the community actually use the option in question. This is exactly the kind of thing newcomers want to know, and have trouble finding. Perhaps it is impolitic to be so open about it, but.... I don't know how complicated this would be to do, but is there any way to make a kind of community scratch space for the documentation? It would be nice to try out and work on reorganized and rewritten documentation before it is linked to directly from clojure.org. Just a thought. N. -- 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
