Note the mixed usages of ResourceTransformer and DuplicatesStrategy#1349
Note the mixed usages of ResourceTransformer and DuplicatesStrategy#1349
ResourceTransformer and DuplicatesStrategy#1349Conversation
There was a problem hiding this comment.
Code Review
The pull request adds documentation to explain the precedence of duplicatesStrategy over transforming and relocating in the ShadowJar plugin. The documentation provides examples in both Kotlin and Groovy. Overall, the changes are clear and helpful for users of the plugin.
Merge Readiness
The documentation changes are clear and accurate. The pull request is ready to be merged. I am unable to directly approve the pull request, and recommend that others review and approve this code before merging.
There was a problem hiding this comment.
Pull Request Overview
This PR updates the documentation regarding the interaction between duplicatesStrategy and resource transforming in the merging process to improve clarity.
- Updated notes to highlight precedence of duplicatesStrategy over resource transformations.
- Added examples in both Kotlin and Groovy to illustrate potential issues with mixing duplicatesStrategy and ResourceTransformer.
Comments suppressed due to low confidence (2)
docs/configuration/merging/README.md:401
- Consider clarifying the term 'transforming' by consistently using 'ResourceTransformer' (or another precise term) to avoid ambiguity with ServiceFileTransformer.
**NOTE:** The `duplicatesStrategy` takes precedence over transforming and relocating. If you mix the usages of
docs/configuration/merging/README.md:422
- Clarify the intended behavior of ServiceFileTransformer when used with duplicatesStrategy. Rephrase the sentence to clearly state whether the exclusion of duplicated service files is an intentional feature or a limitation.
The `ServiceFileTransformer` will not work as expected because the `duplicatesStrategy` will exclude the duplicated
DuplicatesStrategy
DuplicatesStrategyResourceTransformer and DuplicatesStrategy
DuplicatesStrategy#1343.mergeServiceFiles()does not work as expected when usingDuplicatesStrategy.EXCLUDE#1348.