clojure / clojure-site

clojure.org site
https://clojure.org
Eclipse Public License 1.0
249 stars 266 forks source link

Describe deps and cli "Aliases" better #669

Closed adityaathalye closed 6 months ago

adityaathalye commented 9 months ago

The paragraph trailed off at "These Clojure CLI subprocesses use data which can be read from aliases:". Now a cross-reference explains "subprocesses".

The section also disambiguates the top level keyword :deps from the built in alias :deps. The information exists elsewhere in the reference page, but was not obvious in the Aliases section.

Finally, the section surfaces the fact that :deps provides additional programs for the user's perusal. Alias name printing being a handy one.

puredanger commented 6 months ago

Thanks, this is a good catch. I am in the process of overhauling this reference as a companion to the new https://clojure.org/reference/deps_edn page and rather than merge here, I think that discussion is either covered there and will also be updated in the new page.

adityaathalye commented 6 months ago

Acknowledged. Cheers, and happy new year!