You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by bu...@apache.org on 2012/12/14 13:49:16 UTC

svn commit: r842307 - in /websites/staging/isis/trunk: cgi-bin/ content/ content/contributors/release-branch-and-tag-names.html

Author: buildbot
Date: Fri Dec 14 12:49:15 2012
New Revision: 842307

Log:
Staging update by buildbot for isis

Modified:
    websites/staging/isis/trunk/cgi-bin/   (props changed)
    websites/staging/isis/trunk/content/   (props changed)
    websites/staging/isis/trunk/content/contributors/release-branch-and-tag-names.html

Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Dec 14 12:49:15 2012
@@ -1 +1 @@
-1421722
+1421829

Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Dec 14 12:49:15 2012
@@ -1 +1 @@
-1421722
+1421829

Modified: websites/staging/isis/trunk/content/contributors/release-branch-and-tag-names.html
==============================================================================
--- websites/staging/isis/trunk/content/contributors/release-branch-and-tag-names.html (original)
+++ websites/staging/isis/trunk/content/contributors/release-branch-and-tag-names.html Fri Dec 14 12:49:15 2012
@@ -190,20 +190,29 @@
 (they are not synchronized); therefore the branches and the tag names must 
 distinguish the releasable module that they refer to.</p>
 
-<p>Usefully, git allows the same name to be used for both branches and for tags; within git they are namespaced to be unique.  The table below shows the branch name to use when readying the release locally, and the tag name to use when running the <code>release:prepare</code> command itself; as you can see they are identical.  As we've chosen to base the branch/tag name on the <code>artifactId</code> of the pom of the parent module being released, they also happen to be the defaults provided by the <code>maven-release-plugin</code>:</p>
+<p>The table below shows the tag name to use when running the <code>release:prepare</code> command itself, as well as the local branch name to use while preparing the release:</p>
+
+<ul>
+<li>We've chosen to base the tag name on the <code>artifactId</code> of the pom of the parent module being released, as this also happens to be the default provided by the <code>maven-release-plugin</code>.  </li>
+<li>The branch name to use is not actually that important, because it would not usually be pushed to the origin (unless you were preparing the release with some other committer).  However, we recommend that is similar (though not identical to) the tag name. </li>
+</ul>
+
+<p><div class="note">
+In fact, git allows the same name to be used for both branches and for tags; within git they are namespaced to be unique.  However, using the same name for the branch confuses <code>maven-release-plugin</code>; thus the branch name is slightly different from the tag name.
+</div></p>
 
 <table>
 <tr>
 <th>Releasable module</th>
 <th>Branch name to use while readying the release locally</th>
-<th>Tag name pushed during <tt>release:prepare</tt></th>
+<th>Tag name pushed.</th>
 </tr>
-<tr><td>core</td><td>isis-x.y.z</td><td>isis-x.y.z</td></tr>
-<tr><td>objectstore/xxx</td><td>isis-objectstore-xxx-x.y.z</td><td>isis-objectstore-xxx-x.y.z</td></tr>
-<tr><td>profilestore/xxx</td><td>isis-profilestore-xxx-x.y.z</td><td>isis-profilestore-xxx-x.y.z</td></tr>
-<tr><td>progmodel/xxx</td><td>isis-progmodel-xxx-x.y.z</td><td>isis-progmodel-xxx-x.y.z</td></tr>
-<tr><td>security/xxx</td><td>isis-security-xxx-x.y.z</td><td>isis-security-xxx-x.y.z</td></tr>
-<tr><td>viewer/xxx</td><td>isis-viewer-xxx-x.y.z</td><td>isis-viewer-xxx-x.y.z</td></tr>
+<tr><td>core</td><td>prepare/isis-x.y.z</td><td>isis-x.y.z</td></tr>
+<tr><td>objectstore/xxx</td><td>prepare/isis-objectstore-xxx-x.y.z</td><td>isis-objectstore-xxx-x.y.z</td></tr>
+<tr><td>profilestore/xxx</td><td>prepare/isis-profilestore-xxx-x.y.z</td><td>isis-profilestore-xxx-x.y.z</td></tr>
+<tr><td>progmodel/xxx</td><td>prepare/isis-progmodel-xxx-x.y.z</td><td>isis-progmodel-xxx-x.y.z</td></tr>
+<tr><td>security/xxx</td><td>prepare/isis-security-xxx-x.y.z</td><td>isis-security-xxx-x.y.z</td></tr>
+<tr><td>viewer/xxx</td><td>prepare/isis-viewer-xxx-x.y.z</td><td>isis-viewer-xxx-x.y.z</td></tr>
 </table>
 
 <p>where <code>xxx</code> represents a specific component or archetype being released.</p>