Message info
 
To:clojure@googlegroups.com From:Phil Hagelberg Subject:Re: updated Brief Beginner\'s Guide Date:Mon, 7 May 2012 13:47:49 -0700
 

On Mon, May 7, 2012 at 12:13 PM, John Gabriele <jmg3000@gmail.com> wrote:
> I updated the [Brief Beginner's
> Guide](http://www.unexpected-vortices.com/clojure/brief-beginners-guide/index.html).
> Some changes:

This looks like a useful resource; thanks. A few notes:

* Most of the "Distributing" page repeats `lein help tutorial`; would
be better to delegate here.

* When you link to things like the Leiningen sample project.clj or
tutorial, it would be good to mention they're available via `lein
help`

* If you instruct people to edit their skeleton project.clj files to
add clojure 1.4.0, the guide will be out of date soon once the
skeleton is updated.

* A few places it says that Leiningen copies jars into the project
dir, this is no longer true.

* IMO ClojureSphere should have a more prominent mention on the
"Available Clojure Libraries" page.

* The list of Leiningen tasks explained in Chapter 9 (install, deps,
search) is probably ill-chosen since these either aren't typically
needed in daily development (install, deps) or are potentially
frustrating to new users (search is super slow on the first run). I'd
recommend covering repl, test, and jar instead since that's the
minimum needed to get something working and deployed to Clojars.

* Covering how to set up a terminal (Chapter 4) has nothing to do with
Clojure and feels really out of place.

Apart from that it looks pretty solid.

-Phil

--
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+unsubscribe@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en