Cookbook for tools.build

[seancorfield]

Expand on the official guide, based on the sorts of things in my OSS projects (and any other interesting ones out there -- make a call for suggestions!).

[seancorfield]

Feedback from Practicalli on Slack:

I wonder if this is two articles, one to introduce aliases and one to introduce tools.build?
Combining the two seems useful for those new to the Clojure CLI, although there is a lot to scan if only interested in writing a build.clj file.
An alternative approach would be a separate article on Clojure CLI aliases, covering clojure.main and clojure.exec in more detail, e.g https://practical.li/clojure/clojure-cli/defining-aliases/
I actually split aliases and Clojure CLI exec options into a separate page to cover them in more detail too,
e.g https://practical.li/clojure/clojure-cli/execution-options/
Then include a reference to the clojure.main section as background reading in the tools.build page, helping to keep that article focused on one topic, e.g https://practical.li/clojure/clojure-cli/projects/tools-build/
As aliases are intrinsic to the development workflow, I believe it would be useful to have a separate page on Clojure CLI aliases in clojure-doc at some point, as a follow on from the Clojure CLI introduction on clojure-doc.

My response:

It's not intended to be about aliases so much as the whole concept of running a Clojure function from the command-line: -X and -T are very different from -A and -M, but I can see that I may have emphasized aliases too much in that initial section (:ns-default is really the only important part, since that's typically used for -T:build).
I could certainly link to your articles for more about aliases and simplify my -X/-T introduction. I'm trying to make sure clojure-doc.org doesn't unnecessarily duplicate other sites' material (I've managed to delete a lot of old material that is now present on clojure.org, and I'm already deferring to some of your articles in other areas).

[seancorfield]

I linked to the CLI Execution options guide but otherwise left my -X / -T guide as-is.

The tools.build guide is complete at this point.