Hello Stu, I think the "clear no options getting started path" should include a tutorial and focus on the repl and using a *generic* text editor. A downloadable archive file (zip and tar) that included things like jline, clojure jars, and some scripts (.sh *and* .bat) to just start it would allow somebody to party right away.
This package should include a basic tutorial on how to use the repl, including * The basics of the repl -> simple expressions, functions, simple Java interaction * a repl cheat sheet * Any nifty (extra) features bundled with it, e.g: how to javadoc * Explain why a repl is beneficial * Some higher level strategies for benefiting from the repl Then include zero or more tutorials on clojure itself with the package. Zero might be best, and just put the basic tutorials online. This package should be stable. Don't change it willy-nilly. Don't fix it unless its broken. Don't upgrade for the sake of upgrading. If people want to move on to Emacs and swank or slime or whatever, or an ide or start using a build tool, then they will seek those out, but right now that's all a lot of noise that gets in the way of starting with the language because there's so much flux in the state of tooling, which is not a bad thing for the experienced, but it leads to tail chasing on the part of noob. If its stable, then other people can write other tutorials/guides that build off of it w/o worrying about them becoming obsolete. I think I could put together a zip that had a basic environment, but I know I don't know enough to know what else belongs in it. Thanks, Bill On Jul 22, 5:22 pm, Stuart Halloway <stuart.hallo...@gmail.com> wrote: > I am working through a few of the pages on clojure.org with two goals: > > (1) remove or fix anything that is outdated or incorrect > > (2) move to the community site (dev.clojure.org) things that should be > maintained by the community. > > As a first pass, I have trimmedhttp://clojure.org/getting_started, and quite > clearly linked out tohttp://dev.clojure.org/display/doc/Getting+Startedfor > advice on tools, IDEs, etc. > > 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! > > Stu > > Stuart Halloway > Clojure/corehttp://clojure.com -- 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
