You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Brett Porter (JIRA)" <ji...@codehaus.org> on 2008/06/13 03:26:12 UTC
[jira] Updated: (MNG-3327) Deploy site of SNAPSHOT to a different
location than site of release version
[ http://jira.codehaus.org/browse/MNG-3327?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Brett Porter updated MNG-3327:
------------------------------
Fix Version/s: Documentation Deficit
> 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
> Fix For: Documentation Deficit
>
>
> 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