clojure-site VS clojure-cli-config

> At least in the official docs, things should be cleaned up and made much more user friendly.

The source of clojure.org is at https://github.com/clojure/clojure-site/ and it gets a pretty constant stream of updates these days (it even accepts PRs!). It's a huge improvement over what it used to be -- so it depends on what/when you're comparing it to.

If you have specific criticisms or suggestions, I expect they'd be welcomed.

I'll concede the docs could be improved but, hey, feel free to open an issue or PR here https://github.com/clojure/clojure-site instead of arguing with everyone on Reddit, eh?

Eventually, I'm sure there will be a 4th edition of Programming Clojure and it will cover those tools in greater detail, but if you find issues or questions, feel free to file them at https://github.com/clojure/clojure-site/issues or ask on https://ask.clojure.org .

succession - the following of one value after another, as opposed to "updating", in which one value displaces another. Discussion at https://github.com/clojure/clojure-site/issues/188

The ^ macro actually annotates metadata onto the value that read, rather than the resulting runtime value. This is mentioned in the last paragraph on the metadata page, and there's some more explanation in this Github issue.

These are good points and I'd welcome feedback at https://github.com/clojure/clojure-site/issues

Programming Clojure 3rd edition does have some minimal coverage of the CLI but it just barely made it to publication and a lot has been added since. You might find the CLI guide (https://clojure.org/guides/deps_and_cli) and CLI reference (https://clojure.org/reference/deps_and_cli) to be helpful for some questions. The Practicalli guide (https://practical.li/clojure/) has a number of good pages and resources on repl, tools, and use.

Yeah this is grim.

There is https://github.com/practicalli/clojure-deps-edn which solves this but it’s not linked to from any official docs which seems a miss to me. As well as the config and full documentation, it also comes with a video walking you through a demo of all the features.

I was lost when I moved to deps from lein, but just forking and cloning https://github.com/practicalli/clojure-deps-edn as $HOME/.clojure solved the problem - this base deps.edn contained all the aliases I needed - creating a new project, searching and adding dependencies, hooking up data inspectors like portal or reveal, testing, code coverage, benchmarking, building uberjar etc. Moving to deps also introduced me to polylith [1], which has been very useful for building large multi-component projects

[1] https://polylith.gitbook.io/polylith/

When I'm looking for tooling related stuff I do always check practical.li (https://practical.li/clojure/) since it probably has a good, if terse, description and mostly has links to the good documentation (or at least the best available).

4. You need build tooling and it seemed the choices were lein (easy user experience but not “blessed” future direction? - not sure about what i’m saying here but it’s the understanding i formed). Tools.deps is the blessed approach but designed to customise the heck out of it - problematic for a beginner like me! Thankfully you can park the customisation for later and just get started with a well laid out starter https://github.com/practicalli/clojure-deps-edn - there’s even a video walks you through its features, all the inspectors and visualisers are nice to know about but not needed yet on a beginner journey