Skip to content

Add Java Platform Concepts guide for Clojure developers#744

Open
kovan wants to merge 1 commit intoclojure:masterfrom
kovan:docs/java-terminology
Open

Add Java Platform Concepts guide for Clojure developers#744
kovan wants to merge 1 commit intoclojure:masterfrom
kovan:docs/java-terminology

Conversation

@kovan
Copy link

@kovan kovan commented Mar 14, 2026

Summary

New guide explaining the core Java platform concepts that Clojure docs frequently reference without introduction:

  • The JVM — what it is and what it provides
  • The Classpath — how the JVM finds code and resources, and how clj builds it
  • JAR Files — library JARs vs uberjars, what they contain
  • Maven Coordinates — group ID, artifact ID, version, Clojars vs Maven Central
  • Packages and Imports — Java package system and how it maps to Clojure namespaces
  • AOT Compilation — when and why to use it

This addresses feedback from @corasaurus-hex in #543 and @seancorfield's observation that these concepts are a barrier for developers coming from non-Java backgrounds. Linked in the guides index under "Language."

Fixes #543

New guide explaining the core Java platform concepts (JVM, classpath,
JARs, Maven coordinates, packages, AOT compilation) that Clojure
documentation frequently uses without introduction.

Based on feedback that terms like "classpath" and "JAR" are used
throughout the deps and CLI docs and reference pages without being
defined, creating a barrier for developers coming from non-Java
backgrounds.

Fixes clojure#543
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Explain Java terminology before using it

1 participant