Author: dennisl
Date: Thu Nov 1 22:08:29 2012
New Revision: 1404797
URL: http://svn.apache.org/viewvc?rev=1404797&view=rev
Log:
Add instructions on how to stage the latest documentation.
Modified:
maven/site/trunk/src/site/apt/developers/release/parent-pom-release.apt
Modified:
maven/site/trunk/src/site/apt/developers/release/parent-pom-release.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/developers/release/parent-pom-release.apt?rev=1404797&r1=1404796&r2=1404797&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/developers/release/parent-pom-release.apt
(original)
+++ maven/site/trunk/src/site/apt/developers/release/parent-pom-release.apt Thu
Nov 1 22:08:29 2012
@@ -2,8 +2,9 @@
Releasing A Parent POM
-----
Hervé Boutemy
+ Dennis Lundberg
-----
- 2012-10-29
+ 2012-11-01
-----
~~ Licensed to the Apache Software Foundation (ASF) under one
@@ -71,6 +72,40 @@ Releasing A Parent POM
Once these modifications are done, you can follow standard staging steps
taking care to use the <<<site-pom.xml>>> pom,
with <<<mvn -f site-pom.xml ...>>> command, each time the parent POM's site
is generated.
+* Staging the latest documentation
+
+ Once the release is prepared, but before the release vote, the site needs to
be staged.
+
+ The parent POMs are configured to stage the documentation in a "versioned"
directory
+ such as <<</pom/asf-X>>>.
+
+ [[1]] Stage the documentation for the current release version (not the new
snapshot).
+
++------+
+cd target/checkout
+mvn -f site-pom.xml site site:stage-deploy
++------+
+
+ <<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 {{{http://www.apache.org/dev/project-site.html}the
sync}}).
+
++-----+
+http://maven.apache.org/pom/asf-X/
++-----+
+
+ [[2]] Verify/change folder permissions to 0775 and files permissions to
0664. Log on to <<<people.apache.org>>> and
+ change to the directory above the staging directory.
+ Then run these commands:
+
++------+
+cd /www/maven.apache.org/pom
+find . -type d -exec chmod a+rx,g+w {} \;
+find . -type f -exec chmod 664 {} \;
++------+
+
* Updating the Maven site
Check out the maven site project from
<<<https://svn.apache.org/repos/asf/maven/site/trunk>>> or pull the latest
