Deploy site of SNAPSHOT to a different location than site of release version
----------------------------------------------------------------------------
Key: MNG-3327
URL: http://jira.codehaus.org/browse/MNG-3327
Project: Maven 2
Issue Type: Improvement
Components: Documentation: General
Reporter: Benjamin Bentmann
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.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
