Hi Phil, I read through both the tutorial and the readme, and both seem to be pretty clear (though I'm not a new user). They're certainly an improvement on what came before, and it seems to be a pretty solid introduction. Perhaps though, there should be some mention of how the clojure and contrib jars and versions are also included in the project.clj, and are therefore included as a project level dependency.... An approach that is different from what Ruby programmers are used to with gems (i.e. leiningen also manages platform versions) (though not JVM ones).
Explaining this might help people transition from playing with raw clojure builds, to using lein to build real projects. Another comment I have, is that lein's use of lancet isn't especially well documented. This is perhaps more of a deficiency in Lancets documentation, which really needs documenting... especially now that it's a dependency on lein, which is fast becoming a critical tool for most clojure projects. I mention this, because I've written some lein plugins for projects, where my plugins used lancet to perform some additional ant type tasks, e.g. moving files about etc... Lancet itself doesn't seem to wrap all of ant; and it's hard to know where it stops. For example, recently I tried to use lancet to write a lein plugin that would exec another O/S script passing specific parameters to the command. I can't remember the details now, but I seem to remember finding it wasn't possible to pass args to the command. Things like this should be clearer for developers wishing to extend lein further... whether or not this lies in lancets documentation or leins. Anyway, again, great work with lein! R. On 17 June 2010 05:24, Phil Hagelberg <p...@hagelb.org> wrote: > I'm pushing for a Leiningen 1.2.0 release really soon now, and part of > that effort is sprucing up the documentation. I've revamped the readme > and added a tutorial for folks just getting started. Of course, > self-editing is never as good as having outside help, so I'd love it > if I could get some feedback on it. I'm particularly interested in > opinions from people who are just starting out with Clojure--it's easy > for me to take things for granted that not everyone understands. > > Mostly I'd like feedback on the tutorial: > http://github.com/technomancy/leiningen/blob/master/TUTORIAL.md > > But if you've got some time to look over the readme, that would be > great too: http://github.com/technomancy/leiningen/blob/master/README.md > > Thanks! > > -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+unsubscr...@googlegroups.com > For more options, visit this group at > http://groups.google.com/group/clojure?hl=en -- 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
