Hello Olivier and all
Le 2024-08-05 à 19 h 37, Oliver B. Fischer a écrit :
I would say the term module is totally fine. We have, as everywhere in
our human word, a lot of homonyms, everythere.
Yes, this is recognized in both the current documentation and the change
proposal. The documentation of <module> (or <project> with the alias
proposed by Guillaume) currently said: "The modules (sometimes called
subprojects) to build as a part of this project". The change proposal is
"The subprojects (formerly called modules) to build as a part of this
project". So the usage of both terms is still recognized and the change
proposal is mainly a shift of the preferred term.
What is more imporant is to have a good definion of a term before
using it. So what is the definition of a Maven subproject and what
there is it documented.
All POM files start with a <project> root element, so it seems natural
to call them "projects". A sub-project is a project inside a project.
With Guillaume's proposal to accept <projects> as a synonymous of
<modules>, we would have consistent naming: <projects> refers to files
whose root element is <project>.
And how to explain a junior dev why he must call it Maven subproject
but must write module. IMHO this would cause much more confusion then
we all would profit from it
We already have confusion, but between "Java module" and "Maven module".
When I started the work on the Maven compiler plugin, I started by
studying the current code in both the plugin and in Maven core. I have
been confused sometimes about whether "module" in a comment was
referring to Java module or Maven module. By chance, the Maven API
largely uses "Project" in interfaces and method names and the only
inconsistency to fix (to my knowledge) would be the <modules> XML
element. With this changes, I think that confusion would be avoided not
only for Java modules users, but even for those who are not interested
in JPMS by making clearer that a Maven module has all the
characteristics of a project.
Martin
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
