Skip to content

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

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

Rewrite README with usage, status and version guidance#123
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.

Before: badges and The canonical git repository is located at …, nine lines total.

The addition that matters is why you would reach for this:

Useful when a plugin accepts a configuration file that a user might supply as a path, as something on the classpath, or as a URL, and you would rather not write that lookup three times.

That is the actual use case — it is how maven-checkstyle-plugin and friends resolve a ruleset — and neither the README nor the POM description conveyed it.

The example is checked against the real API: addSearchPath, getResourceAsInputStream and getResourceAsFile all exist as shown on ResourceManager, and FileResourceLoader.ID is the loader id.

Ran mvn spotless:apply.

The README was badges and a line saying the canonical repository is
this one. Nothing about what the component does.

Adds a description, status, a dependency snippet, a usage example
checked against ResourceManager and FileResourceLoader, the Java
baseline and documentation links.

Part of codehaus-plexus/.github#58
@slachiewicz slachiewicz added the maintenance Cleanup, refactoring or other internal change label Aug 8, 2026
@slachiewicz
slachiewicz merged commit 6c6792d into master Aug 8, 2026
14 checks passed
@slachiewicz
slachiewicz deleted the docs/readme branch August 8, 2026 19:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Cleanup, refactoring or other internal change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant