[
https://issues.apache.org/jira/browse/MNGSITE-453?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Marcono1234 updated MNGSITE-453:
--------------------------------
Description:
As described in [this StackOverflow
answer|https://stackoverflow.com/a/65533111] the {{groupId}} for {{plugin}}
elements in the POM has a default value of {{org.apache.maven.pugins}}.
However this does not seem to be documented. Even if it is the case that
relying on it is discouraged, it should at least be documented so users which
only see an {{artifactId}} for a plugin understand which {{groupId}} will be
used.
The fact that this is value is specified in the POM XSD file might not suffice;
users will most likely have already invested a lot of time looking at the other
Maven resources before looking at the XSD, or they won't think of looking at
the XSD at all.
Therefore it would be good to (at least) adjust the following two pages to
mention this default {{groupId}}:
- [POM Reference|https://maven.apache.org/pom.html#Plugins]
- [Guide to Configuring
Plug-ins|https://maven.apache.org/guides/mini/guide-configuring-plugins.html]
was:
As described in [this StackOverflow
answer|https://stackoverflow.com/a/65533111] the {{groupId}} for {{plugin}}
elements in the POM has a default value of {{org.apache.maven.pugins}}.
However this does not seem to be documented. Even if it is the case that
relying on it is discouraged, it should at least be documented so users which
only see an {{artifactId}} for a plugin understand which {{groupId}} will be
used.
The fact that this is in them POM XSD file is not documentation; users will
most likely have already invested a lot of time looking at the other Maven
resources before looking at the XSD, or they won't think of looking at the XSD
at all.
Therefore it would be good to (at least) adjust the following two pages to
mention this default {{groupId}}:
- [POM Reference|https://maven.apache.org/pom.html#Plugins]
- [Guide to Configuring
Plug-ins|https://maven.apache.org/guides/mini/guide-configuring-plugins.html]
> POM plugin groupId default value is not (properly) documented
> -------------------------------------------------------------
>
> Key: MNGSITE-453
> URL: https://issues.apache.org/jira/browse/MNGSITE-453
> Project: Maven Project Web Site
> Issue Type: Bug
> Reporter: Marcono1234
> Priority: Minor
>
> As described in [this StackOverflow
> answer|https://stackoverflow.com/a/65533111] the {{groupId}} for {{plugin}}
> elements in the POM has a default value of {{org.apache.maven.pugins}}.
> However this does not seem to be documented. Even if it is the case that
> relying on it is discouraged, it should at least be documented so users which
> only see an {{artifactId}} for a plugin understand which {{groupId}} will be
> used.
> The fact that this is value is specified in the POM XSD file might not
> suffice; users will most likely have already invested a lot of time looking
> at the other Maven resources before looking at the XSD, or they won't think
> of looking at the XSD at all.
> Therefore it would be good to (at least) adjust the following two pages to
> mention this default {{groupId}}:
> - [POM Reference|https://maven.apache.org/pom.html#Plugins]
> - [Guide to Configuring
> Plug-ins|https://maven.apache.org/guides/mini/guide-configuring-plugins.html]
--
This message was sent by Atlassian Jira
(v8.3.4#803005)