Bukama commented on PR #598: URL: https://github.com/apache/maven-site/pull/598#issuecomment-2559824408
> Consider the audience of this document. This simply is not relevant to someone who simply wants to use Maven to build their code. It's only relevant to the people developing Maven and that's not who this is written for. I slightly disagree on that: The audience of this document are all Maven users - those who only want to run their build, but also those who want to know more about the changes, are responsible for build management in their teams, etc (I think someone called them "power users"). If we only considers those who "blindly" use Maven, we don't need the article at all. They are those who still run Maven 3.3.9 and `mvn clean install` because that's what they've read in a tutorial or what was told them years ago. > I'm not sure we can expect people reading this document to already know the difference between build and consumers. This should probably be carefully explained right up front. > What do you think about ``` Throughout the years, one important rule has been maintaining the highest backward compatibility possible, especially with its [POM-schema with Model version 4.0.0][2]. This is very important, because POM files with this schema version are not only used for the build of the own project. Projects, using 3rd party libraries, also rely on the POM files of those, as it contains information needed to successfully run their own builds. Those projects are called "(a dependency) consuming projects". ``` > Also, "consumers" is a strange term here. I might consider dependents instead, but either way it does need to be defined. Used the term "consumers" due the terms the committers introduced when developing this feature. -- 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: issues-unsubscr...@maven.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org