On Wed, Jun 13, 2012 at 7:45 PM, Sean Corfield <seancorfi...@gmail.com> wrote: > We definitely need improvements in the official getting started > documentation. Starting here - > http://dev.clojure.org/display/doc/Getting+Started - any specific > problems / improvements that folks identify will generally get fixed > fairly quickly if they're brought up on this list. There are a couple > of list members who are pretty motivated around improving the "newbie > experience"...
And of course the official clojure-mode and swank-clojure documentation *is* on Github so fork/update/pull request is the natural workflow there. The information in the comments on http://dev.clojure.org/display/doc/Getting+Started+with+Emacs needs to be folded into the main instructions (and the comments deleted, IMO, since they just add to the noise and confusion). The page should start with links to install the current stable version of Emacs for Windows, Linux, Mac. The latest version of swank-clojure should be referenced (1.4.2). The Getting Started with Leiningen page should be updated to cover Windows and Linux/Mac separately (and therefore deal with wget/curl on Windows etc, if that's still needed with lein2?). Part of the frustration stems from it being a bit of a "link chase" because there's no "one page setup" and part stems from various choices being offered as mostly equal (SLIME vs inferior-lisp; manual package.el install vs Marmalade; etc). It's all gradually getting better but newbies are generally the only folks who can provide the right feedback and they're usually too early in the Clojure adoption cycle to know how / where to provide that feedback (and often they're not sure what the docs should say, only that they got into a mess by following them). -- Sean A Corfield -- (904) 302-SEAN An Architect's View -- http://corfield.org/ World Singles, LLC. -- http://worldsingles.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
