elharo commented on code in PR #1606: URL: https://github.com/apache/maven-site/pull/1606#discussion_r3743635641
########## content/markdown/whatsnewinmaven4.md: ########## @@ -67,22 +67,24 @@ article [Introduction to Maven Toolchains][8] by Maven maintainer Maarten Mulder ### Consumer POM -Maven 4 can generate a stripped down consumer POM that removes build information not needed by consumers, and deploys this -to the remote repository. -It does not deploy the `pom.xml` used to build the project. +Maven 4 generates a consumer POM that removes build information not needed by consumers (such as plugin configuration +and properties), and deploys this to the remote repository instead of the full `pom.xml` used to build the project. -The consumer POM is a **flattened** version of the build POM, meaning: +By default, the consumer POM preserves all dependencies from the build POM, including `provided` scope dependencies. +Only build-time-only elements are stripped. -* It contains no parent POM references (all inherited elements are resolved and included directly) +Optionally, flattening can be enabled to produce a fully self-contained consumer POM. When flattening is enabled: Review Comment: Optionally, flattening can be enabled to produce a fully self-contained consumer POM. --> Enable flattening to produce a fully self-contained consumer POM. ########## content/markdown/whatsnewinmaven4.md: ########## @@ -67,22 +67,24 @@ article [Introduction to Maven Toolchains][8] by Maven maintainer Maarten Mulder ### Consumer POM -Maven 4 can generate a stripped down consumer POM that removes build information not needed by consumers, and deploys this -to the remote repository. -It does not deploy the `pom.xml` used to build the project. +Maven 4 generates a consumer POM that removes build information not needed by consumers (such as plugin configuration +and properties), and deploys this to the remote repository instead of the full `pom.xml` used to build the project. -The consumer POM is a **flattened** version of the build POM, meaning: +By default, the consumer POM preserves all dependencies from the build POM, including `provided` scope dependencies. +Only build-time-only elements are stripped. -* It contains no parent POM references (all inherited elements are resolved and included directly) +Optionally, flattening can be enabled to produce a fully self-contained consumer POM. When flattening is enabled: + +* Parent POM references are resolved (all inherited elements are included directly) * BOM imports are flattened into the dependency list -* Only transitive dependencies are kept (compile and runtime scopes) +* Only transitive dependencies are kept (`compile` and `runtime` scopes); non-transitive scopes (`provided`, `test`, `system`) are stripped Review Comment: Transitive dependencies are kept (`compile` and `runtime` scopes). Non-transitive scopes are stripped. (`provided`, `test`, `system` scopes) ########## content/markdown/whatsnewinmaven4.md: ########## @@ -67,22 +67,24 @@ article [Introduction to Maven Toolchains][8] by Maven maintainer Maarten Mulder ### Consumer POM -Maven 4 can generate a stripped down consumer POM that removes build information not needed by consumers, and deploys this -to the remote repository. -It does not deploy the `pom.xml` used to build the project. +Maven 4 generates a consumer POM that removes build information not needed by consumers (such as plugin configuration +and properties), and deploys this to the remote repository instead of the full `pom.xml` used to build the project. -The consumer POM is a **flattened** version of the build POM, meaning: +By default, the consumer POM preserves all dependencies from the build POM, including `provided` scope dependencies. +Only build-time-only elements are stripped. -* It contains no parent POM references (all inherited elements are resolved and included directly) +Optionally, flattening can be enabled to produce a fully self-contained consumer POM. When flattening is enabled: + +* Parent POM references are resolved (all inherited elements are included directly) Review Comment: Try to avoid parenthesized expressions -- 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]
