Re: Leiningen documentation review?

2010-06-29 Thread Phil Hagelberg
On Wed, Jun 16, 2010 at 9:24 PM, 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

Re: Leiningen documentation review?

2010-06-29 Thread Greg
It's great Phil! Thanks for incorporating my suggestions on improving the docs for using local jar files. One unexpected issue that I ran into that would be great if it was explained and documented (because it's different behavior from what most Java/C/C++ devs are used to), is that 'lein

Re: Leiningen documentation review?

2010-06-29 Thread Paul Moore
On 29 June 2010 21:03, Phil Hagelberg p...@hagelb.org wrote: On Wed, Jun 16, 2010 at 9:24 PM, Phil Hagelberg p...@hagelb.org wrote: 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,

Re: Leiningen documentation review?

2010-06-20 Thread Phil Hagelberg
On Thu, Jun 17, 2010 at 11:14 PM, Howard Lewis Ship hls...@gmail.com wrote: I've been using Lein in earnest the last couple of days, prepping for a talk on Clojure for OSCON. I'm hitting enough issues to make me think that 1.2 needs a bit of TLC before a release. I'm looking through the

Re: Leiningen documentation review?

2010-06-18 Thread Howard Lewis Ship
I've been using Lein in earnest the last couple of days, prepping for a talk on Clojure for OSCON. I'm hitting enough issues to make me think that 1.2 needs a bit of TLC before a release. Don't get me wrong; I like Lein, how easy it installs, and how focused it is. I'm just finding that, despite

Re: Leiningen documentation review?

2010-06-18 Thread Chris Perkins
On Jun 17, 12:24 am, Phil Hagelberg p...@hagelb.org wrote: 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

Re: Leiningen documentation review?

2010-06-18 Thread Brian Carper
On Jun 16, 9:24 pm, Phil Hagelberg p...@hagelb.org wrote: Mostly I'd like feedback on the tutorial:http://github.com/technomancy/leiningen/blob/master/TUTORIAL.md It looks quite good. Maybe some mention of `lein clean` is warranted. It would preclude a lot of the Hey I just upgraded library

Re: Leiningen documentation review?

2010-06-18 Thread Phil Hagelberg
On Fri, Jun 18, 2010 at 8:20 AM, Chris Perkins chrisperkin...@gmail.com wrote: On Jun 17, 12:24 am, Phil Hagelberg p...@hagelb.org wrote: This sentence in the README: On Windows you can download lein.bat contains a link to an old and busted version of lein.bat that can only lead to tears and

Re: Leiningen documentation review?

2010-06-18 Thread Phil Hagelberg
On Fri, Jun 18, 2010 at 10:14 AM, Brian Carper briancar...@gmail.com wrote: It looks quite good.  Maybe some mention of `lein clean` is warranted.  It would preclude a lot of the Hey I just upgraded library X and now everything is broken kinds of questions I see on various mailing lists.

Re: Leiningen documentation review?

2010-06-18 Thread Chris Perkins
On Jun 18, 1:21 pm, Phil Hagelberg p...@hagelb.org wrote: On Fri, Jun 18, 2010 at 8:20 AM, Chris Perkins chrisperkin...@gmail.com wrote: This sentence in the README: On Windows you can download lein.bat contains a link to an old and busted version of lein.bat that can only lead to tears

Re: Leiningen documentation review?

2010-06-17 Thread Craig Andera
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 Unnecessary (and ironic! :)) repetition of the word around in this sentence: If you use Ant, you end up copying around a lot of the same tasks around

Re: Leiningen documentation review?

2010-06-17 Thread Manfred Lotz
Hi Phil, On Wed, 16 Jun 2010 21:24:55 -0700 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,

Re: Leiningen documentation review?

2010-06-17 Thread Craig Andera
Mostly I'd like feedback on the tutorial: http://github.com/technomancy/leiningen/blob/master/TUTORIAL.md This sentence: Libraries for the JVM are packaged up as .jar files, which are basically just .zip files with a little extra JVM-specific metadata that contain either .class files

Re: Leiningen documentation review?

2010-06-17 Thread Rick Moynihan
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

Re: Leiningen documentation review?

2010-06-17 Thread Phil Hagelberg
On Thu, Jun 17, 2010 at 4:24 AM, Manfred Lotz manfred.l...@arcor.de wrote: I had a problem with lein that it did not compile all of my files and after quite a while I discovered that I had to tell lein about it in projects.clj by adding a :namespaces statement. Well, don't know if this is the

Re: Leiningen documentation review?

2010-06-17 Thread Phil Hagelberg
On Thu, Jun 17, 2010 at 5:34 AM, Rick Moynihan rick.moyni...@gmail.com wrote: 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.  

Leiningen documentation review?

2010-06-16 Thread Phil Hagelberg
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