clojure-site icon indicating copy to clipboard operation
clojure-site copied to clipboard

Explain Java terminology before using it

Open corasaurus-hex opened this issue 4 years ago • 0 comments

The Deps and CLI Guide and the Using Libs Reference both talk about classpaths without ever introducing what they are or what they mean. In fact, not a lot of the interfacing between Java and Clojure is explained except a little in the Deps and CLI glossary.

@seancorfield pointed to me this really, really excellent guide he made that explains these concepts much more clearly and succinctly than I've seen it explained before. A lot of this has been a complete mystery to me and now I feel like I have somewhat of a grasp on it and I can't tell you how valuable that is.

I've been developing in Clojure professionally for a couple years now and I've never had to know these things (since I have a team with people who generally handle this bit) but having it in such an accessible format would have meant I would have picked it up a lot sooner. 😅

This seems like a classic case of the Curse of Knowledge and a huuuuuuge opportunity to improve the Clojure docs! I'd love to see this integrated into the site somewhere!

corasaurus-hex avatar Jul 22 '21 21:07 corasaurus-hex