svn commit: r1337166 - /incubator/stanbol/site/trunk/content/stanbol/development/index.mdtext

[fc...@apache.org]

Author: fchrist
Date: Fri May 11 13:58:26 2012
New Revision: 1337166

URL: http://svn.apache.org/viewvc?rev=1337166&view=rev
Log:
STANBOL-609 Added release management section

Modified:
    incubator/stanbol/site/trunk/content/stanbol/development/index.mdtext

Modified: incubator/stanbol/site/trunk/content/stanbol/development/index.mdtext
URL: http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/development/index.mdtext?rev=1337166&r1=1337165&r2=1337166&view=diff
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/development/index.mdtext (original)
+++ incubator/stanbol/site/trunk/content/stanbol/development/index.mdtext Fri May 11 13:58:26 2012
@@ -10,8 +10,7 @@ Apache Stanbol source code and contribut
 <a name="dependency-management"></a>
 ## Dependency Management
 
-Apache Stanbol is a modular software stack and therefore all of its modules
-basically have different release cycles. Technically, this modularization
+Apache Stanbol is a modular software stack. Technically, this modularization
 is implemented by the underlying OSGi component infrastructure. Each Apache
 Stanbol component is implemented as an OSGi bundle that can be deployed in
 an OSGi environment. Apache Stanbol uses the OSGi implementation from
@@ -96,8 +95,8 @@ A partial bundlelist is defined by each 
 all required internal and external dependencies that have to be included in a
 launcher in order to make this component work. The dependencies are
 configured in a 'src/main/bundles/list.xml' file of each partial bundlelist
-artifact. The dependencies listed such a file for a partial bundlelist
-are more or less the same as the one defined for the build dependencies in
+artifact. The dependencies listed in such a file of a partial bundlelist
+are more or less the same as the ones defined for the build dependencies in
 the POM. But remember that the partial bundlelists define the dependencies
 needed at runtime and there may be other/more dependencies needed at runtime
 than at build time.
@@ -155,3 +154,40 @@ developer has to keep in mind when writi
 <a name="release-management"></a>
 ## Release Process
 
+Before you do any release related action, you should definitely read the
+[release sections](http://www.apache.org/dev/#releases) on the Apache
+website and the
+[incubator release management pages](http://incubator.apache.org/guides/releasemanagement.html).
+
+The Apache Stanbol release management process is very similar to the one
+followed by the [Apache Sling](http://sling.apache.org/) project. Their
+[release management documentation](http://sling.apache.org/site/release-management.html)
+is a must read for Apache Stanbol committers. 
+
+Apache Stanbol is a modular software stack and therefore all of its modules
+basically have different release cycles. So each component of Apache Stanbol
+may be released independently of others. The only requirement is, that a
+released Apache Stanbol component may not have any SNAPSHOT dependencies to
+any other component it depends on.
+
+To release a single component Apache Stanbol makes use the
+[Maven Release plugin](http://maven.apache.org/plugins/maven-release-plugin/).
+This plugin takes care of checking that there are no SNAPSHOT
+dependencies left. Additionally, there are some checks for legal issues
+automatically performed using the
+[Apache RAT](http://incubator.apache.org/rat/) Maven plugin.
+
+To do a release test build, you have to activate the 'apache-release'
+profile, like it is done in this command:
+
+    $ mvn install -Papache-release
+
+The 'apache-release' profile will be automatically activated when the Maven Release plugin is used. For staging an official release with signing the
+released artifact, making SVN tags, and uploading the artifact to the
+staging repository, you start with
+
+    $ mvn release:prepare
+
+For further information we refer to the
+[Apache Sling](http://sling.apache.org/site/release-management.html)
+website and their very good documentation of doing a release.
\ No newline at end of file