HOWTO RELEASE COCOON 3: Preparations
------------------------------------

* check your workstation's settings as described at http://cocoon.apache.org/1199_1_1.html (step 1)

* update src/main/changes/changes.xml and src/main/site/apt/download.apt in the 'cocoon-docs' module
* go to the 'cocoon-docs' module and run 'mvn site'
* set all versions in the generated pom.xml files of all archetypes
 
* mvn release:prepare release:perform
  (-> from the root directory and from each archetype directory)
 
* tag all modules manually (should write some script for that purpose)
* set all versions in the genreated pom.xml files of all archetypes back to SNAPSHOT
* update <parent> sections of unreleased modules (cocoon-docs, cocoon-sample-webapp)

HOWTO RELEASE COCOON 3: After a successful vote
-----------------------------------------------

* copy the Maven artifacts to the Apache sync repository (people.apache.org):
  cp -R /x1/www/people.apache.org/builds/cocoon/ /x1/www/people.apache.org/repo/m2-ibiblio-rsync-repository/

* copy the distribution files to /x1/www/www.apache.org/dist/cocoon/3.0/ (people.apache.org)

* update the 3.0 branch of our site in SVN
  (--> 'mvn site:deploy' in 'cocoon-docs')
  
* update the website

* upload the Javadocs

* send an announcement mail to announce@apache.org, users@cocoon.apache.org, dev@cocoon.apache.org
 
HOWTO TEST A COCOON 3 RELEASE
-----------------------------

* use the new artifacts in projects that depend on previous or SNAPSHOT versions. Add the Cocoon staging repository to your ~/.m2/settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <profile>
      <id>cocoon-staging</id>
      <repositories>
        <repository>
          <id>cocoon.staging</id>
          <name>Cocoon staging repository</name>
          <url>http://people.apache.org/builds/cocoon</url>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>cocoon.staging</id>
          <name>Cocoon staging repository</name>
          <url>http://people.apache.org/builds/cocoon</url>
        </pluginRepository>
      </pluginRepositories>
    </profile>
</settings>

and use it: e.g. mvn install -P cocoon-staging

* use all archetypes:
mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create -DarchetypeGroupId=org.apache.cocoon.archetype-sample -DarchetypeArtifactId=cocoon-archetype-sample -DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany -DartifactId=mysample -DremoteRepositories=http://people.apache.org/builds/cocoon/ 

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create -DarchetypeGroupId=org.apache.cocoon.archetype-block -DarchetypeArtifactId=cocoon-archetype-block -DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany -DartifactId=mysite -DremoteRepositories=http://people.apache.org/builds/cocoon/ 

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create -DarchetypeGroupId=org.apache.cocoon.archetype-parent -DarchetypeArtifactId=cocoon-archetype-parent -DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany -DartifactId=myparent -DremoteRepositories=http://people.apache.org/builds/cocoon/ 

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create -DarchetypeGroupId=org.apache.cocoon.archetype-webapp -DarchetypeArtifactId=cocoon-archetype-webapp -DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany -DartifactId=mywebapp -DremoteRepositories=http://people.apache.org/builds/cocoon/ 

* check GPG, MD5 and SHA1 files