gnodet opened a new pull request, #1802:
URL: https://github.com/apache/maven-site/pull/1802
## Summary
Enhances the Maven Mixins guide with a new **"Mixins vs. Packaging"**
section that explains when to use each mechanism.
The question came up naturally while working on apache/maven#13658 (the
`maven-plugin-mixin` — a JSR 269 annotation processor delivered as a mixin to
replace `<packaging>maven-plugin</packaging>` for Maven 4 plugins).
## What's added
- Explains the two roles of `<packaging>`: artifact type declaration (backed
by `ArtifactHandler`) and lifecycle binding injection (backed by
`LifecycleMappingProvider`)
- Explains what mixins do: POM-level composition via plugin/dep/property
merging
- Decision guide: clear bullet lists for when to use each
- Concrete example: the `maven-plugin-mixin` pattern that replaces
`<packaging>maven-plugin</packaging>` in Maven 4, including the bootstrap
problem it solves
- Summary comparison table
Also fixes a tense issue in the intro ("will provide" changed to "provide")
since Maven 4.1 has shipped.
## Related
- apache/maven#13658 — `maven-plugin-mixin`: the motivating concrete example
- apache/maven-site#681 — open issue: "Create Guide about using custom
packaging"
- [x] I hereby declare this contribution to be licensed under the [Apache
License Version 2.0, January 2004](https://www.apache.org/licenses/LICENSE-2.0)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
