Releasing a Maven plugin is much the same as any other Maven project. The following guide walks through most of the steps:
Note that plugins have particular conventions for deploying the project site. When encountered in the release process above, perform the following steps:
Once the release is prepared, but before the release vote, the site needs to be staged.
The plugin parent POM is configured to stage the documentation in a "versioned" directory such as /plugins/maven-XXX-plugin-Y.Z.
cd target/checkout mvn site site:stage-deploy -Preporting
Note: It requires Maven 2.1.0 or higher to successfully deploy to people.apache.org via SSH. Older Maven versions will fail due to com.jcraft.jsch.JSchException: Algorithm negotiation fail.
Note: You should verify the deployment of the site on the Maven website (you need to wait the sync).
http://maven.apache.org/plugins/maven-XXX-plugin-Y.Z/
Some developers have reported problems with the site:stage-deploy goal. In that case, you can stage the site locally and upload it manually:
mvn site site:stage -Preporting scp -r target/staging/people.apache.org/www/maven.apache.org/plugins/maven-XXX-plugin YOUR_APACHE_USERNAME@people.apache.org:/www/maven.apache.org/plugins/maven-XXX-plugin-Y.Z
cd /www/maven.apache.org/plugins
find . -type d -exec chmod a+rx,g+w {} \;
find . -type f -exec chmod 664 {} \;
After the release has passed, the site needs to be uploaded.
Note: Be sure to generate and deploy the site using the same version of the release. Typically, you need to check out the tag (or go to target/checkout)
cd target/checkout mvn site-deploy -Preporting
Note: You can not just copy the documentation from the staging site above into the released documentation as the links are not identical. See the email thread http://www.nabble.com/forum/ViewPost.jtp?post=24018250&framed=y
To review the site, wait for the files to arrive at
http://maven.apache.org/plugins/maven-XXX-plugin/
The wait is necessary to allow the site to be rsync'ed into production.
Check out the maven site project from https://svn.apache.org/repos/asf/maven/site/trunk or pull the latest changes if already checked out.
Update the version number for the plugin on the src/site/apt/plugins/index.apt page.
Commit your changes and then deploy the site.
mvn clean site-deploy