On May 7, 4:47 pm, Phil Hagelberg <[email protected]> wrote: > On Mon, May 7, 2012 at 12:13 PM, John Gabriele <[email protected]> wrote: > > I updated the [Brief Beginner's > > Guide](http://www.unexpected-vortices.com/clojure/brief-beginners-guide/inde...). > > Some changes: > > This looks like a useful resource; thanks.
You're welcome! Thanks for the feedback. > A few notes: > > * Most of the "Distributing" page repeats `lein help tutorial`; would > be better to delegate here. Yes, I see there's some duplication there. Though, the tutorial covers a lot of ground, and in an order that I might not have chosen. I wanted to focus that "Distributing" chapter strictly on the topic of creating a program runnable as a jar. > * 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` I like pointing users to the online versions because they get nicely- rendered html versions that way. > * 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. Yes, though, I wanted it to be up-to-date. I'll update it again once lein includes 1.4 by default. > * A few places it says that Leiningen copies jars into the project > dir, this is no longer true. Thanks, missed those. Updated the "Installing" and "Development Environment" chapters. > * IMO ClojureSphere should have a more prominent mention on the > "Available Clojure Libraries" page. I purposely kept the notions of "what categories of libs are available" (std lib, contrib, other Clojure libs, Java libs), and "where can I find libs" separate and in separate chapters. As for ClojureSphere, unfortunately, I don't know much about it other than that it appears to aggregate data on various Clojure libraries (from github mostly?) regarding library dependencies and dependents. There's no About page there, and the github repo doesn't include any explanatory documentation. I've previously emailed its creator but haven't heard back. That said, I've added an additional note about how it appears to be able to list libs according to how many other libs use them. > * 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 included "install" and "deps" because I thought a new user would be looking at those commands in `lein help` and wondering if they needed to use them. I adjusted to notes on `lein search` to advise the user to use the web search forms instead. >I'd > recommend covering repl, test, and jar instead since that's the > minimum needed to get something working and deployed to Clojars. I think those are covered well enough elsewhere. I mostly wanted to add some notes regarding lein subcommands that I thought might be confusing. > * Covering how to set up a terminal (Chapter 4) has nothing to do with > Clojure and feels really out of place. That could very well be. :) I like the content there, but also added a link to skip to the next section. ---John -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to [email protected] Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/clojure?hl=en
