Describe deps and cli "Aliases" better #669
Closed
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. nb. I've signed the CA. Ref: my github user `adityaathalye` listed at https://clojure.org/dev/contributors
|
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. |
|
Acknowledged. Cheers, and happy new year! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
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
:depsfrom 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
:depsprovides additional programs for the user's perusal. Alias name printing being a handy one.adityaathalyeat https://clojure.org/dev/contributors