Author: bimargulies
Date: Mon Oct 31 19:52:33 2011
New Revision: 1195636
URL: http://svn.apache.org/viewvc?rev=1195636&view=rev
Log:
Add a helpful hint about checking on the state of the site *before* staging a
release.
Modified:
maven/site/trunk/src/site/apt/developers/release/maven-project-release-procedure.apt
Modified:
maven/site/trunk/src/site/apt/developers/release/maven-project-release-procedure.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/developers/release/maven-project-release-procedure.apt?rev=1195636&r1=1195635&r2=1195636&view=diff
==============================================================================
---
maven/site/trunk/src/site/apt/developers/release/maven-project-release-procedure.apt
(original)
+++
maven/site/trunk/src/site/apt/developers/release/maven-project-release-procedure.apt
Mon Oct 31 19:52:33 2011
@@ -52,6 +52,20 @@ Performing a Maven Project Release
* {{{./maven-shared-release.html} Releasing a Maven shared component or
subproject}}
* {{{./maven-core-release.html} Releasing Maven Core}}
+
+* Consider updating the parent versions
+
+ If the item you are planning to release is not using the most recent version
of its parent,
+ consider taking this opportunity to update to it.
+
+* Make sure that site compilation and publication works
+
+ Particularly if you update the parent (but sometimes under other
circumstances),
+ the site compilation process may fail, or reveal a conspicuous error,
+ or deploy to the wrong location. It is stressful and time-consuming
+ to discover this *after* you stage a release and then try to follow
+ the procedure to deploy the site for review. So you may find it more
+ pleasant to check out the state of the site before you start.
* Stage the Release