Author: sebb
Date: Fri Jun  7 22:29:03 2013
New Revision: 1490855

URL: http://svn.apache.org/r1490855
Log:
How to choose TAG names

Modified:
    commons/cms-site/trunk/content/xdoc/releases/prepare.xml

Modified: commons/cms-site/trunk/content/xdoc/releases/prepare.xml
URL: 
http://svn.apache.org/viewvc/commons/cms-site/trunk/content/xdoc/releases/prepare.xml?rev=1490855&r1=1490854&r2=1490855&view=diff
==============================================================================
--- commons/cms-site/trunk/content/xdoc/releases/prepare.xml (original)
+++ commons/cms-site/trunk/content/xdoc/releases/prepare.xml Fri Jun  7 
22:29:03 2013
@@ -456,7 +456,13 @@
         Do <code>svn diff</code> and <code>svn status</code> to check that the 
changes are OK.
         These should only show changes to the POMs.</p>
 
-        <p>Create the RC tag, by copying the tag workspace to SVN:</p>
+        <p>Create the RC tag, by copying the tag workspace to SVN as below. 
+          The tag name should include the component name, as this makes it 
easier to distinguish checkouts.
+          Try to follow the existing naming convention so the tag names will 
sort in a reasonable order.
+          For example NET uses NET_M_N_RC1, and LANG has a similar convention.
+          For an example of how <b>not</b> to do it, see 
https://svn.apache.org/repos/asf/commons/proper/io/tags/
+          The IO tags don't sort properly.
+        </p>
 
       <pre>
       svn copy foo-1.2-RC1 -m "Creating foo-1.2-RC1 tag" 
https://svn.apache.org/repos/asf/commons/proper/foo/tags/foo-1.2-RC1


Reply via email to