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>