Skip to content

Rewrite README with usage, status and version guidance - #151

Merged
slachiewicz merged 1 commit into
masterfrom
docs/readme
Aug 8, 2026
Merged

Rewrite README with usage, status and version guidance#151
slachiewicz merged 1 commit into
masterfrom
docs/readme

Conversation

@slachiewicz

Copy link
Copy Markdown
Member

Part of codehaus-plexus/.github#58. Same skeleton as the merged pilots.

The Backward Compatibility section is kept verbatim — I diffed it to confirm. That section is the reason I picked this repo as the model when proposing the skeleton in the first place: it records why org.codehaus.classworlds cannot be removed, which Sisu bytecode references it, and the PR that tried and had to be reverted. The skeleton is built around it, not over it.

What is added is the part that was missing: what the library actually does.

Classworlds replaces the strict parent-child classloader tree with a pool of realms that can import specific packages from each other — a directed graph rather than a hierarchy. That is how Maven keeps a plugin's dependencies from colliding with its own.

That was on the project site but not here, and "A class loader framework" (the POM description) does not convey it.

Plus the dependency snippet, Java baseline and doc links, and the 2015 redirect line removed.

Ran mvn spotless:apply.

Adds what the library does - realms as a directed graph rather than a
hierarchy, which is how Maven isolates plugins - plus the launcher, a
dependency snippet, the Java baseline and documentation links.

The Backward Compatibility section is kept verbatim. It is the most
valuable documentation in the organisation: it records why the legacy
org.codehaus.classworlds package cannot be removed, which Sisu bytecode
references it, and the PR that tried and had to be reverted. The
skeleton is built around it rather than over it.

Drops the 2015 'current master is now at' line.

Part of codehaus-plexus/.github#58
@slachiewicz slachiewicz added the maintenance Cleanup, refactoring, internal change label Aug 8, 2026
@slachiewicz
slachiewicz merged commit 371a3bc into master Aug 8, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Cleanup, refactoring, internal change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant