Hey Phil, thanks for the response. >> trying to navigate whether to use >> 1.x or 2.x preview is a bit confusing--and the variety of docs >> available for setting things up is confusing. > > Yeah, as of the last release we're pretty much advising everyone to go > with 2.x, but the docs still need to be updated to reflect that. What > are some of the confusing docs you mention? Most people have said the > install process is pretty simple.
To be fair, I probably had problems based on how I am used to using github rather than any failure of the docs. The actual process is simple, you are right. I was trying to set up 2.0.0 preview but the docs focus(ed) on the 1.x version, and it wasn't quite clear how that worked at the time I set it up (a few weeks ago)--the link wasn't obvious, and when pulling from git I wasn't sure what version I was getting. And in any case I see that someone updated the Leiningen readme on github to promote 2.x first and foremost since last time I checked: nice. That should help if anyone has confusion similar to mine, so this is probably moot. The variety of docs just refers to all the random tutorials out there if you do a Google search. Again, not really fair to compare to the official Leiningen docs, which are pretty helpful. More generally, I think a certain amount of this is unavoidable; newbs will always be confused, there will always be a variety of conflicting third-party tutorials available for any framework, and transitioning from one major version to the next is always painful. So I expect this will smooth out as the community continues to grow and get more folks coming in. >> Similarly, it's easy to >> get lost (as a beginner) between namespace issues with packages and >> how to set things up properly with Leiningen. It'd be good to have >> some documentation on that. > > Maybe if the Leiningen tutorial linked to > http://blog.8thlight.com/colin-jones/2010/12/05/clojure-libs-and-namespaces-require-use-import-and-ns.html? > Warning, digression: you know, I read that, and I still find the differences between use and require confusing. I have to go back and re-read it, and practice more. But, for example, I had trouble figuring out how to include new directories so that midje test files were picked up in my lein projects, with properly named namespaces. There is probably a smart and Clojure-esque way to handle all of this. But I found it hard to figure out at first, and I think I'm still not doing it right--I'm using the load-file function, which doesn't really have anything to do with namespaces. Again, I apologize, I know that was a digression. In fact, I like slogging through things and figuring out the best practices in somewhat indirect ways, getting that "aha" moment when something I read a month ago finally clicks, like I expect Mr. Jones' article to do at some point. But I also realize not everyone has that level of patience...or perhaps more accurately, masochism. >> All of that said, maybe I'll take a look at the docs and see if I can >> add anything constructive, since I've set it up now a few times on >> Macs. > > That would be great; thanks. We could also use some help improving > http://leiningen.org; it's pretty messy right now. Cool, I'll see what I can contribute! > -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
