Author: markt
Date: Wed Oct 19 15:20:14 2005
New Revision: 326729
URL: http://svn.apache.org/viewcvs?rev=326729&view=rev
Log:
Add some guidance for the use of the sandbox directory. This is just my view so
feel free to modify it.
Added:
tomcat/sandbox/README.txt
Added: tomcat/sandbox/README.txt
URL:
http://svn.apache.org/viewcvs/tomcat/sandbox/README.txt?rev=326729&view=auto
==============================================================================
--- tomcat/sandbox/README.txt (added)
+++ tomcat/sandbox/README.txt Wed Oct 19 15:20:14 2005
@@ -0,0 +1,52 @@
+General
+=======
+
+The sandbox is for experimental development of Tomcat components. The
components
+may provide new functionality or improve existing functionality.
+
+Components may be targetted at one or more Tomcat versions.
+
+
+Life-cycle
+==========
+
+The life-cycle of a sandbox component is:
+1. Create new component in sandbox
+2. Develop it
+3. Do one of
+ i) Incorporate it in the standard Tomcat source trees
+ ii) Release it as a separate component
+ iii) Archive it for future reference
+
+
+SVN
+===
+
+Sandbox components should be developed in a sub-directory of the
/tomcat/sandbox
+directory. Developers may choose whether to add source directly under the
+component's directory or to create the standard subversion /trunk/, /branches/
+and /tags/ directories and add the source under the /trunk/ directory.
+
+The svn commands to do this will look something like:
+svn mkdir https://svn.apache.org/repos/asf/tomcat/sandbox/component
+svn mkdir https://svn.apache.org/repos/asf/tomcat/sandbox/component/trunk
+svn mkdir https://svn.apache.org/repos/asf/tomcat/sandbox/component/branches
+svn mkdir https://svn.apache.org/repos/asf/tomcat/sandbox/component/tags
+
+
+Releases
+========
+
+Components may be released from the sandbox but only as alpha or beta. If
+releases are made, then the standard subversion structure of /trunk/,
+/branches/ and /tags/ must be used.
+
+Stable releases may not be made from the sandbox.
+
+All releases are subject to the same voting rules as any other Tomcat release.
+
+If released as a separate component, and if it does not already exist,
+a new top level directory (/tomcat/modules/) will need to be created and a
+sub-directory for the new component should be created under the modules
+directory. At this point, the standard svn /trunk/, /branches/ and /tags/ must
+be used for each component.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
