svn commit: r1416544 - in /isis/site/trunk/content: contributors/about.md contributors/release-snapshot.md documentation.md

[da...@apache.org]

Author: danhaywood
Date: Mon Dec  3 14:32:22 2012
New Revision: 1416544

URL: http://svn.apache.org/viewvc?rev=1416544&view=rev
Log:
isis site -copying over stuff re: snapshot releases

Added:
    isis/site/trunk/content/contributors/release-snapshot.md
Modified:
    isis/site/trunk/content/contributors/about.md
    isis/site/trunk/content/documentation.md

Modified: isis/site/trunk/content/contributors/about.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/contributors/about.md?rev=1416544&r1=1416543&r2=1416544&view=diff
==============================================================================
--- isis/site/trunk/content/contributors/about.md (original)
+++ isis/site/trunk/content/contributors/about.md Mon Dec  3 14:32:22 2012
@@ -4,5 +4,6 @@ Title: Contributors
 - [Git workflow](git-workflow.html)
 - [Coding conventions](coding-conventions.html)
 - [Updating the CMS site](updating-the-cms-site.html)
+- [Release snapshot](release-snapshot.html)
 - [Release process](release-process.html)
 - [Key generation](key-generation.html)

Added: isis/site/trunk/content/contributors/release-snapshot.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/contributors/release-snapshot.md?rev=1416544&view=auto
==============================================================================
--- isis/site/trunk/content/contributors/release-snapshot.md (added)
+++ isis/site/trunk/content/contributors/release-snapshot.md Mon Dec  3 14:32:22 2012
@@ -0,0 +1,51 @@
+Title: Deploying a Snapshot Release
+
+The only prerequisites for performing a release is that the contributor has configured their environment. This involves updating your `~/.m2/settings.xml` file:
+
+<pre>
+&lt;settings&gt;
+  &lt;servers&gt;
+    &lt;!-- To publish a snapshot of some part of Maven --&gt;
+    &lt;server&gt;
+      &lt;id&gt;apache.snapshots.https&lt;/id&gt;
+      &lt;username&gt;xxx&lt;/username&gt;
+      &lt;password&gt;yyy&lt;/password&gt;
+    &lt;/server&gt;
+    ...
+  &lt;/servers&gt;
+  ...
+&lt;/settings&gt;
+</pre>
+
+where `xxx` and `yyy` constitute your apache LDAP username and password.
+
+This information is as documented in the [ASF documentation](http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env).
+
+{note
+It is also possible to configure to use `.ssh` secure keys, and thereby avoid hardcoding your Apache LDAP password into your `.m2/settings.xml` file. A description of how to do this can be found, for example, [here](http://incubator.apache.org/bval/cwiki/release-setup.html).
+}
+
+### Sanity Check
+
+Before deploying the snapshot, perform a quick sanity check:
+
+* builds ok (`mvn clean install`)
+* an example app runs ok
+
+### Deploy All Modules
+
+Deploy all modules using:
+
+<pre>
+mvn -D deploy=snapshot deploy
+</pre>
+
+This will deploy all the modules that make up a release.
+
+To confirm that they are present, browse to Apache's [Nexus repository manager](https://repository.apache.org) and search for "isis".
+
+{note
+The deploy process is liable will take a long time.  Go grab a bite of lunch.
+}
+
+

Modified: isis/site/trunk/content/documentation.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/documentation.md?rev=1416544&r1=1416543&r2=1416544&view=diff
==============================================================================
--- isis/site/trunk/content/documentation.md (original)
+++ isis/site/trunk/content/documentation.md Mon Dec  3 14:32:22 2012
@@ -48,6 +48,7 @@ Title: Documentation
 ###  Committers
 
 - [Updating the CMS site](contributors/updating-the-cms-site.html)
+- [Release snapshot](contributors/release-snapshot.html)
 - [Release process](contributors/release-process.html) [wip]
 - [Key Generation](contributors/key-generation.html)
 
@@ -184,7 +185,7 @@ Title: Documentation
 ###  JDO `no release`
 
 - [About](components/objectstores/jdo/about.html) [stub]
-- [Maven and Eclipse](components/objectstores/jdo/hints-and-tips.html) [stub]
+- [Maven and Eclipse](components/objectstores/jdo/hints-and-tips.html)
 
 }