Details
-
Improvement
-
Status: Closed
-
Major
-
Resolution: Incomplete
-
None
-
None
-
None
Description
This issue is not directly targetted at the Maven core but something general the Maven developers should consider since Maven is about best practices:
It is a bad practice to deploy sites of SNAPSHOTs to the same location as the final release version. The ordinary user who runs Maven simply using release versions of the plugins should be able to read the corresponding documentation, not documentation for a different plugin version. For example, take http://maven.apache.org/plugins/maven-antrun-plugin/examples/tasksAttributes.html which describes a feature of the upcoming release which is not yet available. It may take users a while to realize that this documentation is for the SNAPSHOT version of the AntRun plugin and hence not usable in a production build.
Therefore, I would suggest to deploy release sites to something like
maven.apche.org/plugins/maven-X-plugin
(as now) and the SNAPSHOT site to
maven.apche.org/plugins/maven-X-plugin/snapshot
or similar. This should be easy using a profile.